home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / utility / 4file310.zip / 4F.DOC < prev    next >
Text File  |  1993-10-16  |  104KB  |  2,088 lines

  1.                           -------------------
  2.                      =====   4 - F I L E S   =====
  3.                           -------------------
  4.  
  5.                      DOCUMENTATION  -  Version 3.10
  6.  
  7.   --------------------------------------------------------------------
  8.   Shareware by Larry T. Edwards, Copyright 1990-93 All Rights Reserved.
  9.      Hand-Crafted Software   Box 6001   Sitka, Alaska   99835   USA
  10.  
  11.  REGISTRATION: For a single user, send $30 ($34 overseas) to the above
  12.  address; price includes printed manual and free upgrades.  For credit
  13.  card orders, call or send to: (1) PsL and specify program #10574,
  14.  800-242-4775 or P.O. Box 35705 Houston, Tx 77235 USA; or (2) CompuServe
  15.  (!GO SWREG) and specify program #912.  Orders direct to the author are
  16.  preferred.  For multiple installations see 4F-SITE.TXT.
  17.  
  18.  TECH SUPPORT:
  19.  <1> Call the author at 907-747-8996.
  20.  <2> E-mail: CompuServe 72037,3607 or Internet:72037.3607@compuserve.com.
  21.  <3> MAS-BBS, 718-444-5089 (8,N,1, 2400-14400).  IMPORTANT: Select the
  22.      Support Area, then the 4FILES Area (downloads on first call).
  23.  
  24.         _______
  25.    ____|__     |
  26. --|       |    |-------------------  |  ASP wants to make sure the shareware
  27.   |   ____|__  |  Association of     |  principle works for you; its Ombuds-
  28.   |  |       |_|  Shareware          |  man can help resolve any dispute with
  29.   |__|   o   |    Professionals      |  an ASP member on a shareware related
  30. -----|   |   |---------------------  |  problem.  Details on page 3.
  31. (R)  |___|___|       MEMBER
  32.  
  33.  
  34. (Pages are formatted for 75 column, 12 Cpi, 6 Lpi printing)
  35.  
  36. ===========================================================================
  37.  CONTENTS OF MANUAL ...
  38. =======================   File & Note Modes .. 11   OS/2 & DESQview .... 27
  39.  
  40. Overview of 4FILES .. 2   Using FILE MODE .... 11   Safety Features .... 28
  41.  
  42. About 4DOS & NDOS ... 2   Sorting File Lists . 14   Hot Tips on 4FILES.. 30
  43.  
  44. Shareware Notice .... 3   Utility Ports ... 15-17   Origin/Evolution ... 32
  45.  
  46. QUICK START ......... 3   Using NOTE MODE .... 18   Detail Installation  33
  47.  
  48. Special Keys ........ 5   Configuring 4FILES . 20   Agreement for Use .. 34
  49.  
  50. Drive:Dir Navigation 10   EMS & XMS Swaps .... 20   Registration Benefit 34
  51.  
  52. Seeking a File ..... 11   Video & Screens .... 24   Packing List ....... 36
  53.  
  54. Mouse 10-11,16,20-22,     MS-Windows ......... 25   Registration Form .. 37
  55.                   26,27
  56. ===========================================================================
  57.  
  58.                                                                          2.
  59. AN OVERVIEW OF 4FILES
  60. =====================  4FILES is a multi-purpose file manager which also
  61. includes a full-featured editor for 4DOS & NDOS "file notes" and the
  62. ability to act as a "front-end" for your favorite utilities and applica-
  63. tions programs. A special effort has been made to make the interface clean
  64. and convenient. Command keystrokes are simple, to the point, and easy to
  65. remember.  A very efficient method of directory navigation is provided.  A
  66. built-in configuration routine makes on-the-fly changes of 4FILES'
  67. settings a simple matter, including changes to the "utility ports" (which
  68. are used to call your utilities and other programs), colors, and many
  69. custom setup choices.  International keyboards and character code pages
  70. are fully supported.
  71.  
  72. The 4FILES screen shows the contents of the current directory with
  73. subdirectories at the top followed by files, each taking a full line. The
  74. list may be sorted any way you like, either on-the-fly or via command line
  75. switches. Except for sorts by file name (the default), the key field for
  76. the current sort is highlighted on-screen.  Any video mode of 80x25 or
  77. higher is supported.
  78.  
  79. File and subdirectory names are displayed on the left half of the screen,
  80. one per line, with full statistics.  The right half is space for
  81. descriptive file notes.  If you are using 4DOS or NDOS (superior
  82. COMMAND.COM substitutes), a file note will remain associated with its
  83. file during copy, move and rename operations.  4FILES works fine with
  84. COMMAND.COM too, except that your notes will be lost during the above
  85. file operations.  The new 4DOS-4.0 description "extensions" are detected
  86. if present, but no programs are using them yet.
  87.  
  88. Full file management facilities are provided via simple mnemonic key
  89. commands for single files and marked groups of files.  These include file
  90. copy,  move, rename, and rename; and create, remove, or rename
  91. directory.  There is  also support for ZIP, ARJ, LHA and other types of
  92. file archives.
  93.  
  94. Any program file or batch file may be executed directly from the 4FILES
  95. screen, and any file or directory name can be quickly dropped into an
  96. editable DOS command line.  Also, "executable extensions" are supported,
  97. allowing you to select a data file and automatically load it into the
  98. appropriate application program, such as a word processor or database.  You
  99. can also drop back to DOS while leaving 4FILES loaded, and your place in
  100. 4FILES will be saved.
  101.  
  102. There is an internal routine for branding this copy (or later copies you
  103. might  obtain from bulletin boards or your vendor) with the serial number
  104. you will be  given when you register.  Branding deactivates the
  105. registration reminder  screen.
  106.  
  107.  
  108. AN ASIDE ABOUT 4DOS & NDOS
  109. ==========================  4FILES is at its best when 4DOS or NDOS is used
  110. instead of COMMAND.COM; however, 4FILES is only one small reason to select
  111. one of these excellent command interpreters.  The ability they provide to
  112. annotate your files will revolutionize your computer use, and their powers
  113. go far beyond that, providing many time and frustration saving features
  114. which are missing in MSDOS.  I cannot recommend these award winning
  115.  
  116.                                                                          3.
  117.  
  118. products highly enough.  4DOS is shareware (NDOS is not), so it will cost
  119. you nothing more than download time or a handling charge to try it.  Since
  120. 4DOS is a very long download, the shareware version is available from Hand-
  121. Crafted Software (maker of 4FILES), along with other shareware and public
  122. domain programs mentioned in this manual (see registration form).  Or you
  123. can get 4DOS directly from JP Software at 800-368-8777.
  124.  
  125. For brevity, all following references to 4DOS refer to NDOS as well.
  126.  
  127.  
  128. SHAREWARE NOTICE
  129. ================  4FILES is commercial, copyrighted software and is
  130. distributed as shareware.  The shareware is a marketing method allows you
  131. to evaluate a fully functional program before deciding whether you want to
  132. keep it.  If you decide to keep 4FILES, you must purchase it by sending in
  133. the registration form with full payment.  You may not continue use of
  134. 4FILES beyond a period of 30-days from date of first use, unless the copy
  135. you are using has been properly registered for your use and your use
  136. complies with the agreement near the end of this manual.
  137.  
  138. If you decide not to register, a frank critique or trouble report would
  139. be sincerely appreciated, via a collect phone call, E-mail, or a letter.
  140.  
  141. Your distribution of 4FILES to others is highly encouraged, provided that
  142. the distribution complies with the agreement at the end of this manual.
  143. Permission for commercial distribution may be withdrawn at any time.
  144.  
  145. Larry Edwards is a member of the Association of Shareware Professionals
  146. (ASP).  ASP wants to make sure the shareware principle works for you.  If
  147. you are unable to resolve a shareware-related dispute or problem with a
  148. member, ASP's Ombudsman may be able to help resolve it.  ASP does not
  149. however provide technical support for members' products.  ASP Ombudsman:
  150. 545  Grover Rd, Muskegon, MI 49442-9427; FAX=616-788-2765; CIS Mail=ASP
  151. Ombudsman 70007,3536.
  152.  
  153.  
  154. QUICK START  Capacity: 798 records per directory.
  155. ===========
  156.              Requires: DOS 3.0+ and 46-110K (depending on directory size).
  157.  
  158.              SYNTAX:   4F [d:][\][subdir] [/+ /8 /L] [/D] [/E /S /C /N /U]
  159.  
  160.                        Items in brackets are optional.
  161.                        The current directory is loaded by default.
  162.  
  163.              MANY FEATURES WILL NOT WORK UNTIL 4FILES IS CONFIGURED.
  164.              <ALT-F10> BRINGS UP THE CONFIGURATION SCREEN.
  165.  
  166. ** Installation: Either copy all files into a subdirectory listed in your
  167. PATH or write a 4DOS alias to call 4FILES, preferably specifying the full
  168. pathspec to speed loading.  Either method allows you to start 4FILES by
  169. typing just its name or alias, regardless of which drive or directory you
  170. are logged onto at any time.  Also, you need to create a TEMP environment
  171. variable pointing to RAMdisk or hard disk directory. If you don't
  172. understand, please see the detailed instructions on page 33.
  173.  
  174.                                                                           4.
  175.  
  176. ** 4FILES may also be installed under Windows, OS/2 or DESQview, and icons
  177. are provided for the first two.  See detailed instructions on pages 25-27.
  178.  
  179.  
  180. ** Symbols in menus and this manual:  "@" means the ALT key, "^" means the
  181. CTRL key, and "$" means the shift key.
  182.  
  183.  
  184. ** Quitting: Under DOS, <@ESC> quits to the current directory, and <ESC> or
  185. <^ESC> quit to the original (startup) directory.  You may disable plain
  186. <ESC> via the configuration menu, and there are advantages to doing so.
  187. Under Windows, <$ESC> terminates 4FILES, and <@ESC> and <^ESC> have their
  188. normal Windows functions.
  189.  
  190.  
  191. ** Configure 4FILES by typing <@F10>.  Screen colors & blinking, "utility
  192. ports," many options, and registered copy branding are on this menu.  Your
  193. utilities, especially a browse utility such as LIST or TV, must be
  194. configured here for some 4FILES features to work, including HELP.  A
  195. pathspec for a utility is unneeded if the utility is in the PATH, but will
  196. give best performance.  The extension MUST be given with the filename; if
  197. the "utility" is a 4DOS alias, use the .ALS extension.
  198.  
  199.  
  200. ** Laptop computers:  On the Configuration Options screen, select keyboard
  201. type "3".  This will substitute easier-to-use keys for several important
  202. functions.  The normal keys will not even work on some laptops.  See key
  203. mappings in the next section.
  204.  
  205.  
  206. ** Modify or Replace your Old .CFG File:  At a minimum, you will need
  207. to set the three "At Exit" switches on the Configuration Options menu.
  208. If you are upgrading from a version prior to 2S.0, delete your 4F.CFG
  209. file and do a new configuration.
  210.  
  211.  
  212. ** Switches: /R /E /S /C /N and /U are command line switches for list
  213. sorting (see P.9): respectively, for sorts by Reverse order, Extension,
  214. Size, Chronology, Note characters, and actual DOS order.  Alphabetical
  215. sorting is the default.  /R may be used alone or with any of the other
  216. four.  If you are upgrading, note that the old /D switch is now /R, and /T
  217. is now /C.
  218.  
  219. /8 is used to force an 80x25 display, in case you want to switch
  220. automatically while loading or in case of an incompatibility with the
  221. video mode  detection.  /+ must be used with HGC, MDA or CGA for over
  222. 80x25.
  223.  
  224. The /L (Lock) switch causes NumLock to be restored to "numeric" when
  225. 4FILES exits, and is useful when using 4FILES with CAD and other number
  226. intensive programs.
  227.  
  228. /M causes file marks from a previous session to used again rather than be
  229. discarded.  Marks are normally retained only for the current session.
  230. This may also be permanently set from the Configuration Options screen.
  231.  
  232.                                                                           5.
  233.  
  234. You may automatically run 4FILES with whatever switches you desire by
  235. calling it via a batch file or 4DOS alias.
  236.  
  237. ** Operation: Use the menu line for guidance, and go with the flow!
  238. Mnemonic keys are used for file management functions, and are shown on
  239. the following pages and the help screen.  <TAB> toggles between File & Note
  240. Modes.  Some keys work in both modes, but are shown only on the menu of one
  241. due to line length limits.  Navigate with the <G+> key (Grey-plus), <G->
  242. and <G*> if you have an AT keyboard.  Other keys will need to be used for
  243. PC and laptop keyboards (see below).  If 4FILES is properly configured,
  244. <F1> shows help and <^F1> shows this manual.  For a tour of a few
  245. features see #7 on page 34.  The tour assumes your bootup directory is
  246. the current directory, and that it has a \UTIL subdirectory.
  247.  
  248. ** 4FILES may be fully evaluated under COMMAND.COM, except the MOVE command
  249. works only with 4DOS, DRDOS, or MSDOS 6+.  For proper handling of file
  250. notes during file copy, move, rename and delete (either from within 4FILES or
  251. from the DOS command line), your COMSPEC environment variable specify 4DOS.COM
  252. or NDOS.COM as the secondary (if not also the primary) command interpreter,
  253. instead of COMMAND.COM.  Also, it is important that the ".COM" extension be
  254. included in the COMSPEC listing for any of the above command interpreters.
  255.  
  256.  
  257. =========================
  258. DOCUMENTATION OF FEATURES
  259. =========================
  260.  
  261. SPECIAL CONTROLS
  262. ================  Most keys act as expected, and the others (below) are
  263. laid out logically.  A special keyboard handler allows nice, normally
  264. unavailable key assignments.
  265.  
  266. NOTE:  Symbols:  ^ is the CTRL key, @ is the ALT key, $ is the shift key.
  267.  
  268. Important Keys
  269. --------------
  270.  
  271.               <@-F10>  -- Shows the configuration menu.
  272.               <TAB>    -- Toggles between FILE MODE and NOTE MODE.
  273.  
  274.  
  275. Function Keys
  276. -------------
  277.                                NORMAL
  278.                              ┌────┬────┐
  279.                 Help *       │ F1 │ F2 │  Edit Current File *
  280.                              ├────┼────┤
  281.                 File Finder* │ F3 │ F4 │  Archive utility *
  282.                              ├────┼────┤
  283.                 Mark File    │ F5 │ F6 │  Unmark File
  284.                              ├────┼────┤
  285.          Toggle Time/Attrib  │ F7 │ F8 │  (Utility of your choice)*
  286.                              ├────┼────┤
  287.         Execute Program, or  │ F9 │ F0 │  Paste Text
  288.         Cut Text (note mode) └────┴────┘
  289.  
  290.                                                                          6.
  291.                                CONTROL
  292.                              ┌────┬────┐
  293.            View this manual* │ F1 │ F2 │  2nd Editor or Word Processor *
  294.                              ├────┼────┤
  295.                              │ F3 │ F4 │
  296.                              ├────┼────┤
  297.            Mark All Files    │ F5 │ F6 │  Unmark All Files
  298.                              ├────┼────┤
  299.                              │ F7 │ F8 │
  300.                              ├────┼────┤
  301.           Cut Selected Text  │ F9 │ F0 │
  302.                              └────┴────┘
  303.  
  304.  
  305.                               ALTERNATE
  306.                              ┌────┬────┐
  307.           Copy a Whole Note  │ F9 │ F0 │  Reconfigure 4FILES.
  308.                              └────┴────┘
  309.  
  310.  
  311.           "*" means 4FILES Utility Ports must be configured properly for
  312.           the feature to work.
  313.  
  314.   NOTE:
  315.  
  316.   1.  As adjuncts to <F5/F6>, <Space> toggles the current file mark and
  317.       <^Space> toggles all marks.  <^/> and <^\> duplicate <^F5> and <^F6>.
  318.  
  319.   2.  ^X duplicates the function of <F9>.
  320.  
  321.  
  322.   HERE IS THE SAME KEY MAPPING SHOWN FOR THE HORIZONTAL FUNCTION KEY LAYOUT.
  323.  
  324.       F1     F2     F3     F4     F5     F6     F7     F8     F9      F0
  325.    ┌──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬───────┬──────┐
  326. Nrm│Show  │Editor│ Any  │Arch. │ Mark │UnMark│Show *│ Any  │ EXEC/ │Paste │
  327. ---│Help  │#1    │ Util │Util. │ File │File  │Attrib│ Util │ COPY* │Text  │
  328.    ├──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼───────┼──────┤
  329. Ctl│Show  │Editor│      │      │ Mark │Unmark│      │      │ Cut   │      │
  330. ---│Manual│#2    │      │      │ All  │All   │      │      │ Text  │      │
  331.    └──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┼───────┼──────┤
  332.                                                        Alt │ Copy  │CONFIG│
  333.  * F9=Execute in File-Mode; Copy-text in Note-Mode.    --- │ Note  │4FILES│
  334.                                                            └───────┴──────┘
  335.  
  336.  
  337.  
  338. NAVIGATION KEYS FOR DRIVES, DIRECTORIES & LISTS
  339. -----------------------------------------------
  340.  
  341.  One of 4FILES' strengths is its efficient and flexible mapping of
  342.  system  navigation features to the keyboard.  Three keys control
  343.  drive-changes and several ways of changing directories.  One of the keys
  344.  controls three features through a logical progression of single, double
  345.  or triple taps.  Another key has a dual function -- if the highlighted
  346.  record is a  directory it changes to the directory; if the record is a
  347.  
  348.                                                                          7.
  349.  
  350.  file or archive, its contents are viewed. The mapping and functions are
  351.  simple and easy to remember -- and the keys are handily close to the
  352.  arrow and page keys.
  353.  
  354.  The navigation keymapping depends on the type of keyboard you are using.
  355.  4FILES attempts to choose an AT or PC keyboard for you based on a test
  356.  of the keyboard BIOS, but this is not foolproof and may be overridden
  357.  from the Configuration Options screen.  The laptop keyboard cannot be
  358.  automatically detected, and must always be explicitly selected.  Here are
  359.  the active navigation keys:
  360.  
  361.  
  362.           AT KEYBOARD                                  PC KEYBOARD
  363.   ════════════════════════╗             ═════════════════════════════╗
  364.      ────┐ ┌────┐ ┌────┐  ║                           ┌───────────┐  ║
  365.          │ │ G* │ │ G- │  ║                           │ Scl Lock  │  ║
  366.         ─┘ └────┘ └────┘  ║                           └───────────┘  ║
  367.        ──┐ ┌────┐ ┌────┐  ║                           ┌────┐ ┌────┐  ║
  368.          │ │    │ │    │  ║     ("G" means            │    │ │ G- │  ║
  369.        ──┘ └────┘ │ G+ │  ║       grey key.)          └────┘ └────┘  ║
  370.         ─┐ ┌────┐ │    │  ║                           ┌────┐ ┌────┐  ║
  371.          │ │    │ │    │  ║                           │    │ │    │  ║
  372.        ──┘ └────┘ └────┘  ║                           └────┘ │ G+ │  ║
  373.         ─┐ ┌────┐ ┌────┐  ║                           ┌────┐ │    │  ║
  374.                                                       │    │ │    │  ║
  375.                                                       └────┘ └────┘  ║
  376.           (Choose your keyboard on the Config Menu.)
  377.  
  378.                           ┌────┐ ┌────┐┌─────┐   ║
  379.          Laptop Keyboard  │ [  │ │  ] ││     │   ║
  380.                           └────┘ └────┘│     │   ║
  381.                                  ┌─────┘     │   ║
  382.                                  │   Enter   │   ║
  383.                                  └───────────┘   ║
  384.                                                  ║
  385.  
  386. The <Scroll-Lock> and <[> keys have the same function as <G*> depending on
  387. the choice of keyboard type, and will always be referred to as <G*> in
  388. this manual.  Similarly, <]> will be included in all references to <G->
  389. and <Enter> as <G+>.
  390.  
  391. AT KEYBOARDS (KB=1):
  392.  
  393.  <G*>     Drive change via a single key.
  394.  <G**>    Directory change via an input field.
  395.  <G***>   Goto PREVIOUS drive\directory.
  396.  
  397.  <G->     Goto PARENT directory.
  398.  
  399.  <G+>     Goto HIGHLIGHTED directory.  <ENTER> may be configured as a
  400.           substitution in File Mode only.  (On a highlighted FILE, <G+>
  401.           will view the file or archive.)
  402.  
  403.                                                                         8.
  404.  
  405. PC KEYBOARDS (KB=2):
  406.  
  407.  <Scrl-Lock>                        Drive change via a single key.
  408.  <Scrl-Lock><Scrl-Lock>             Directory change via an input field.
  409.  <Scrl-Lock><Scrl-Lock><Scrl-Lock>  Goto PREVIOUS drive\directory.
  410.  
  411.  <G-> Goto PARENT directory.
  412.  
  413.  <G+> Goto HIGHLIGHTED directory.  <ENTER> may be configured as a
  414.       substitution in File Mode only.  (On a highlighted FILE, <G+> will
  415.       view the file or archive.)
  416.  
  417.  
  418. LAPTOP KEYBOARDS (KB=3):
  419.  
  420.  <[>      Drive change via a single key.
  421.  <[[>     Directory change via an input field.
  422.  <[[[>    Goto PREVIOUS drive\directory.
  423.  
  424.  <]>      Goto PARENT directory.
  425.  
  426.  <ENTER>  Goto HIGHLIGHTED directory. <ENTER> may be configured as a
  427.           substitution in File Mode only. (On a highlighted FILE, <G+>
  428.           will view the file or archive.)
  429.  
  430.  <@-Char> -- Fast scroll to next record starting with the character.
  431.              <SCL-LK> or <Keypad-5> changes search direction (the former
  432.              for AT and laptop keyboards, the later for PC keyboards).
  433.  
  434.  
  435. NOTE MODE KEY COMMANDS:
  436. -----------------------
  437.  
  438.   ^H          -- Destructive backspace (see also File Mode).
  439.  
  440.   ^W          -- Write note edits to disk?  Choices given are (S)ave or
  441.                  (A)bandon unsaved edits.  This also works in File Mode.
  442.  
  443.   ^Y          -- DELETE NOTE.
  444.   @^Y         -- Delete tail of note (from cursor to end).
  445.  
  446.   <Ctrl-PgUp> -- Go to TOP of directory listing.
  447.   <Ctrl-PgDn> --  "  " END  "     "        "
  448.  
  449.   <Ctrl-Up>   -- Go to TOP of page.
  450.   <Ctrl_Dn>   --  "  " END  "   "
  451.  
  452.                                                                          9.
  453.   <Sh-Up>     -- Scroll display to show record ABOVE TOP of page.
  454.   <Sh-Dn>     --    "      "     "   "    "    BELOW END  "   "
  455.   <Ctrl-Lf>   -- Shift cursor ONE WORD LEFT.
  456.   <Ctrl-Rt>   --   "      "   ONE WORD RIGHT.
  457.  
  458.   <Sh-Rt>     -- 1) Bump text to the right of the cursor to right margin.
  459.                  2) If no text to the right, enter Flush-Right (FLR) mode.
  460.   <Sh-Lf>     -- Exit FLR mode (or use <ESC>, <CR> or any bar movements).
  461.   <Sh-BS>     -- Destructive "Fore-space", available in FLR mode only.
  462.  
  463.   <ESC>       -- Like <^ESC>. Can be disabled with a configuration switch.
  464.  
  465.   <^ESC> or <@ESC> -- Quit to original or current directory, respectively,
  466.                       DOS only. (If you use NEWKEY, see page 16.)  Under
  467.                       Windows & OS/2 these keys have their normal meanings.
  468.  
  469.   <Sh-ESC>    -- Terminate 4FILES.  Active in Windows and OS/2 only.
  470.  
  471.  
  472. FILE MODE KEYCOMMANDS:
  473. ----------------------
  474.  
  475.   <^E> or
  476.   <^E><^E> -- Presents a DOS command line with or without the current
  477.                file name.  Appending "++" to a command freezes the screen
  478.                temporarily after execution, or freezing can be permanently
  479.                set via the Configuration Options screen.  Executing a
  480.                blank command line shells to a secondary "real" DOS session.
  481.  
  482.   <^H>      -- Shell to 4DOS & show the selectable command history window.
  483.                KEYSTACK.COM (a 4DOS TSR) must be loaded before 4FILES.
  484.  
  485.   <^X>      -- Instantly executes records that are .COM, .EXE, .BAT or .BTM
  486.                files; also acts on data files with "executable extensions".
  487.  
  488.  <F7> or
  489.  <NUM-LK>   -- Toggles between showing file attributes and file time.  The
  490.                works only on non-laptop keyboards; <F7> works on all.
  491.  
  492.  
  493.   FOR FILES
  494.   ---------
  495.   A / ^A  -- Change attributes of current file or all marked files.
  496.   C / ^C  -- Copy current file or all marked files.
  497.   D / ^D  -- Delete current file or all marked files.
  498.   M / ^M  -- Move file or all marked files.
  499.   R / ^R  -- Rename current or marked files.  (LCD 4.0B+ & ACD compatible.)
  500.   S       -- Resort the listed files with a new sort type or order.
  501.  
  502.   FOR DIRECTORIES
  503.   ---------------
  504.   N       -- Create a "New" Directory.  LCD/ACD/NCD compatible.
  505.   K       -- "Kill" (remove) highlighted directory. LCD/ACD/NCD compatible.
  506.   R       -- Rename current directory.  Descriptive note, if any, will be
  507.              lost.  (LCD 4.0B+ and ACD compatible.)
  508.   <G**>   -- Change directory.  (See above for KB=2 or 3 substitutions.)
  509.  
  510.                                                                         10.
  511.  
  512.   FOR DISKS
  513.   ---------
  514.   V       -- Shows volume data, including bytes free and an editable
  515.              Volume Label.
  516.  
  517.   FILE MARKING
  518.   ------------
  519.   <F5>  / <F6>   --  Mark and Unmark the CURRENT file.
  520.   <^F5> / <^F6>  --  Mark and Unmark ALL files.
  521.   <^/>  / <^\>   --    "   "    "     "    "
  522.   <Space>        --  Toggle mark on CURRENT file.
  523.   <^Space>       --  Toggle marks on ALL files.
  524.  
  525.  
  526. ====================================
  527. DRIVE & DIRECTORY NAVIGATION DETAILS
  528. ====================================
  529.  
  530. After hitting <G*> (or one of the substitute keys for other keyboards) you
  531. will be prompted to enter a drive letter. A valid entry will cause an
  532. immediate change to the drive.  A second hit on <G*> (instead of typing a
  533. drive letter) presents an input field for specifying a new directory
  534. and/or drive.  <G***> makes an immediate change to the previous directory.
  535.  
  536. The <G**> command is compatible with LCD, ACD or NCD (directory changing
  537. utilities) if 4FILES has been configured to use one of them, allowing you
  538. to enter fragmentary path names for directory changes.  This REALLY saves
  539. time.  The databases used by these programs are updated by 4FILES when
  540. directories are created, deleted or renamed.
  541.  
  542. Hitting <G+> while the cursor is on a subdirectory record will cause 4FILES
  543. to change to that subdirectory.  If this is the ".." record, the change
  544. will be to the parent of the current directory.  <G-> is preferable
  545. though, since it will change to the parent directory from ANY record.
  546.  
  547. When changing to a parent directory, the cursor will quick-scroll from the
  548. top of the listing down to the record of the subdirectory you just left.
  549. This is helpful when inspecting a succession of child directories, since
  550. you always return to your last place in the parent, rather than its first
  551. record.  The scrolling action gives a quick impression of your current
  552. location in the list.
  553.  
  554.  
  555. MOUSE NAVIGATION & OTHER USES
  556. =============================  The navigation key commands are mirrored
  557. in the mouse commands.  For three button mice you will see that commands
  558. for navigating the listing are also included.  Navigation functions are
  559. denoted here with AT-keyboard key symbols.
  560.  
  561.                                                                          11.
  562.  
  563.    MOUSE BUTTONS: |  L--    M--    R--     L-R     LM-      -MR      LMR
  564.    ===============|========================================================
  565.    3 Button Mouse | <G+>   <G->   <ESC>   <TAB>   <PgUp>   <PgDn>   <F9>
  566.                   |
  567.    2 Button Mouse | <G+>          <ESC>   <G->
  568.  
  569.    NOTE: (1) Mouse type is automatically detected.
  570.          (2) OS/2's Presentation Manager disables the middle mouse button!
  571.          (3) See the Mouse Use section for more information.
  572.  
  573. The mouse handler is setup so that no action is taken until all depressed
  574. buttons have been released.  To experiment, for a 'page-down' hold down
  575. the right button -- no rush -- and hit the middle button at your leisure.
  576. Then lift one finger -- again no rush -- and when the second finger is
  577. lifted the action is taken.
  578.  
  579. To use the mouse when running under MS-Windows, the mouse driver must be
  580. loaded before loading Windows, otherwise the mouse will not function in
  581. Windows DOS sessions.
  582.  
  583. The handler remains active in called utilities, giving mouse capability
  584. to utilities which have none.  The right-button (<ESC>) will quit the
  585. utility, but the hair-trigger may also terminate 4FILES accidentally.
  586. For this reason, <ESC> may be disabled as a means of terminating 4FILES.
  587.  
  588.  
  589. SEEKING A FILE ON THE LIST
  590. ==========================  Scrolling to a file in a directory listing is
  591. easy: just hit an <@-char> key, where "char" is the alpha or numeric first
  592. character of the file or directory name.  You will be delivered to the next
  593. occurrence of a record starting with that character.  On AT and laptop
  594. keyboards <SCL-LK> toggles the search direction at any time, including in
  595. mid-search.  On PC keyboards, <Keypad-5> performs this function instead
  596. since <SCL-LK> is used for directory navigation.
  597.  
  598.  
  599. FILE MODE & NOTE MODE
  600. =====================  4FILES starts in FILE MODE, with the file management
  601. functions are enabled.  <TAB> toggles between File Mode and Note Mode.  You
  602. will notice that the menu changes with the mode, and you will find that
  603. while every command on each menu will work in its mode, some will also
  604. work in the other mode.  There is not a enough space on the single menu
  605. line to list all commands for each mode, but they are logical and you'll
  606. catch on.
  607.  
  608. ===============
  609. USING FILE MODE
  610. ===============
  611.  
  612.     The file mode commands are mnemonic keys:
  613.  
  614.     <C>opy, <M>ove, <R>ename, <D>elete, and <A>ttributes for single files.
  615.  
  616.     <^C>opy, <^M>ove, <^R>ename, <^D>elete, <^A>ttributes and <^Z>ip for
  617.     marked files.
  618.  
  619.                                                                          12.
  620.  
  621.     <N>ew-directory, <K>ill-directory, <R>ename-directory for directories.
  622.  
  623.     <^E>xecute-field, <^E^E>xecute DOS shell, e<^X>ecute-now, and
  624.     <^H>istory list execution.
  625.  
  626.     <V>olume information.
  627.  
  628.  
  629. File Management
  630. ---------------
  631. Copy, move and rename rely directly on 4DOS resources, and keep the file
  632. notes with their files.  Any errors (i.e. disk full, etc.) are trapped,
  633. flagged on the 4FILES screen, and stored in the file 0-4F-DOS.ERR.  This
  634. is so named to always be found at or near the top of an alphabetical
  635. directory listing.  Ctrl-L will cause this file to be displayed using your
  636. file browser, and when exiting the display you be prompted whether to
  637. delete the error file.  For disks which are full, write protected or
  638. read-only, 4FILES will store 0-4F-DOS.ERR in your TEMP directory, if one
  639. is specified in your system environment.
  640.  
  641. Under COMMAND.COM (but not under 4DOS), some simple errors such as 'drive
  642. door open' will neither trapped by 4FILES nor be displayed on screen by DOS.
  643. The DOS operation will seem 'stalled,' but typing Ctrl-Break will correctly
  644. break this lock and return you to the 4FILES screen.
  645.  
  646. The Z and ^Z (Zip) commands are for archiving files, and support ARJ and
  647. LHA  archivers as well as PKZIP.  The archiver is selected based on the
  648. extension  given for the target file, and .ZIP is the default if none is
  649. given.  File  notes remain associated with their files in ZIP archives,
  650. and this feature will  also be added for ARJ files as soon as possible.
  651. To unzip the comments 4FILES  puts in an archive, you can port the
  652. shareware program 4UNZIP to the <F4> key.   (4FILES will soon have an
  653. internal function to completely replace the need for  4UNZIP, and will be
  654. able to provide the same service for ARJ files.)
  655.  
  656. History lists are maintained separately for target file names for copy/
  657. move, archive (Z/^Z) and rename commands.  A common target path history
  658. list is maintained for those commands which use it.  The list capacities
  659. are all ten strings.  The input field is initially blank, but pressing the
  660. DownArrow key will display the current filename for editing.  The oldest
  661. filename is next in line.  UpArrow accesses (from blank input fields) the
  662. most recent list addition.
  663.  
  664. A and ^A are mnemonic commands to change file attributes.  If plain A is
  665. hit, an editable image of the current file's actual attributes is displayed
  666. for modification.  If ^A is hit (operating on marked files), a template
  667. instead of an actual image is shown. In the template, each attribute letter
  668. is initially preceded by a "?" wildcard, indicating that the existing
  669. attribute will be unchanged.  Repeatedly typing an attribute character (R,
  670. A, S or H) toggles the action on that attribute through a cycle of, for
  671. example, ?R, +R, -R, and back to ?R.  + and - indicate the attribute will
  672. be forced "ON" or "OFF" for each file.
  673.  
  674. Especially with the ^A command it is useful to be able to see the current
  675. attributes for all files at once, but the default is to not display them.
  676.  
  677.                                                                          13.
  678.  
  679. The file creation time field may be toggled between showing time and file
  680. attributes via the <F7> or <Sh-NumLock> key, which are functional in both
  681. File and Note Modes.  <F7> is functional for all keyboards, and the other
  682. key only for non-laptop keyboards.
  683.  
  684. D deletes the current file, and requires a double-tap of the "Y" key for
  685. confirmation.  The double tap is a safety feature, so that typing
  686. something like "dynamic" in File Mode when you think you are in Note Mode
  687. will not delete the current file.  ^D acts on all marked files, and has a
  688. simple yes/no confirmation.
  689.  
  690. Note that for the marked file and archiving operations to work as fast as
  691. possible you should have a temporary directory, named TEMP, set up.  In
  692. AUTOEXEC.BAT you can put a statement like:  SET TEMP=d:\ where "d" is a
  693. RAMDISK or hard drive.  A directory may be added if desired.  4FILES
  694. deletes its temporary files when done with them.
  695.  
  696. The V key displays volume information for the current disk, including the
  697. number of free bytes and an editable Volume Label.
  698.  
  699.  
  700. File Execution
  701. --------------
  702. ^E presents a DOS command line loaded with the name of the current record
  703. name, and the line editor is forced into insert mode.  The cursor controls
  704. are identical to those for the note editor.  ^E^E provides a blank command
  705. line in which you may enter any command; just like the DOS command line.
  706. ^Y deletes the command.  A history list with a capacity of ten strings is
  707. maintained for the ^E and ^E^E commands.
  708.  
  709. The typed-in command is executed, and when it finishes the return to 4FILES
  710. is automatic.  In many situations this is desirable, but in some cases (the
  711. DOS SET command is an example) the information you want to see flashes off
  712. the screen.  To prevent this there are two ways to cause 4FILES to delay
  713. clearing the screen until a key is hit.  One is to set the configuration
  714. switch named "Pause after ^E" to Yes (NO is the factory default).  The
  715. other is to append ++ to the ^E command line.  ++ is a 4FILES flag, and is
  716. not actually part of the command.  Either the <G+> or <Shift=> may be used
  717. to generate +.  If the switch is set to YES, a "- -" appendage will force
  718. an immediate return.
  719.  
  720. If you wish to work directly from the real DOS prompt for a while, type
  721. ^E^E <CR>.  Executing the blank command line will load a secondary DOS
  722. shell, and you will remain in the shell until you type EXIT to return to
  723. 4FILES (see 4FILES Tip #5, below).  Back in 4FILES, you will be returned
  724. to the same drive:directory you were in before.
  725.  
  726. The ^X or <F9> command will execute the current file immediately with no
  727. prompting if it is an executable file or is a data file for which you have
  728. set up an executable extension.  This command may be forced to pause after
  729. execution with the "Pause after ^X" configuration switch.  An executable
  730. extension may be set up with a statement such as this in your AUTOEXEC.BAT
  731. file:
  732.  
  733.                        SET DOC=C:\WP\WP.EXE
  734.  
  735.                                                                          14.
  736.  
  737. If you press ^X or <F9> on a file with a .DOC extension, 4FILES will then
  738. load it into Word Perfect for you.
  739.  
  740.  
  741. Directory Management
  742. --------------------
  743. <N>ew-directory and <K>ill-directory are commands to make and remove
  744. directories.  <R>ename works both for subdirectories and files.  These
  745. commands update ACD, LCD, and NCD databases, if 4FILES is configured to
  746. use one of these utilities.
  747.  
  748.  
  749. MARKING FILES
  750. -------------
  751. There are several ways to mark files.  <F5> & <F6> mark and unmark
  752. records for the above marked file operations.  <SPACE> toggles the mark
  753. of the current file.  <^F5> & <^F6> mark and unmark all records, and <^
  754. SPACE> toggles the marks of all files.  <^/> and <^\> duplicate the <^F5>
  755. and <^F6> keys for Windows compatibility.
  756.  
  757. A count of marked files and marked bytes is shown on the second line in a
  758. special configurable color.  Marking may be done in both File & Note
  759. Modes.  Marked file operations automatically pass over subdirectories and
  760. hidden files, and marking of DESCRIPT.ION is expressly blocked.  Note
  761. however that UPON EXIT OR DURING THE NEXT DIRECTORY CHANGE, if no file
  762. notes remain, DESCRIPT.ION will be deleted for you automatically.  An
  763. empty DESCRIPT.ION may also be deleted via the "D" single file command.
  764.  
  765. When changing directories or calling a utility, any file marks are saved in
  766. a file named DEMARCAT.ION, kept in the current directory.  When entering or
  767. returning to a directory, if this file is found the marks are restored.
  768. The exception is that if the file was written during a previous 4FILES
  769. session it is instead deleted.  So, within a session all marks remain
  770. until they are unmarked, but they are usually not "sticky" between
  771. sessions.
  772.  
  773. There are two ways to have "sticky" marks, if you wish.  One is via a
  774. Configuration Menu switch.  The other is the /M command line switch.  The
  775. later is particularly useful to reuse marks on the spur of the moment, if
  776. the menu switch is "off." The marks in the current directory would
  777. otherwise be lost when 4FILES loads, before you have a chance to change
  778. the menu switch.
  779.  
  780.  
  781. SORTING THE LIST OF FILES
  782. -------------------------
  783. While the subdirectory portion of the list is always alphabetically
  784. sorted, the files-portion may be sorted in various ways either on-the-fly
  785. or via command line switches.  The default sort is alphabetical, in
  786. ascending order.  To change the sort on-the-fly, type S while in DOS
  787. mode. After making a selection, which may involve making settings for
  788. both type of sort and for ascending or descending order, a second tap on
  789. the last key hit will exit the sort menu and cause the sort to be made.
  790. <CR> will exit also.
  791.  
  792.                                                                          15.
  793.  
  794.     The command line sort switches are described below.  /D may be used by
  795. itself or in combination with other switches, and affects only the primary
  796. sort. The following sorts also apply to on-the-fly setting::
  797.  
  798.         SWITCH          PRIMARY SORT          SECONDARY SORT
  799.         -------        -----------------     ------------------
  800.         DEFAULT         FILENAME               .EXT
  801.           /E            .EXT                   FILENAME
  802.           /S            File Size              FILENAME.EXT
  803.           /C            Chronological          FILENAME.EXT
  804.           /N            File Note              FILENAME.EXT
  805.  
  806.           /U            Unsorted, DOS order    --
  807.           /D            Descending Order       Descending Order
  808.  
  809. /D may be combined with any of the other switches.  Except when sorting by
  810. filename, the primary sort field is highlighted with a color that is set on
  811. the configuration menu.  For (U)nsorted, the filename field is highlighted.
  812. Only files, never subdirectories, are sorted.  International code pages are
  813. used for sorting as appropriate.  The "tips" section has more on sorting.
  814.  
  815.  
  816. =============
  817. UTILITY PORTS    FILE BROWSING, EDITING, UNZIPPING, DUPLICATES, etc.
  818. =============    ---------------------------------------------------
  819.  
  820. Some of 4FILES' most useful functions are performed by automatically
  821. executing other programs at the stroke of a key.  "Utility ports" are the
  822. means by which you associate such programs with their various 4FILES
  823. control keys and setup 4FILES to send the command line information
  824. (switches, filenames, etc.) they need to be fed.  These ports appear on
  825. the Configuration Utility Ports screen, and they allow you to easily
  826. customize 4FILES to use your favorite utilities or other programs.
  827.  
  828. Several programs are recommended below for use in various ports.  If you
  829. don't have these utilities or equivalents, they may be downloaded free on
  830. your first call to my BBS, which is a subsystem of MAS-BBS in New York.
  831. The latest version of 4FILES and a collection of pertinent utilities are
  832. found there in separate directories. See page 1 for log-on instructions.
  833. Also, I can mail you a full set of useful shareware and public domain
  834. utilities (including 4DOS, which is not available on the BBS) -- see the
  835. registration form for details.
  836.  
  837.  
  838. BROWSING FILES
  839. --------------
  840. The <G+> key (or its substitute) is overloaded in a sensible way.  Not
  841. only will it allow you to "see" the contents of a subdirectory, if the
  842. highlighted record is a file, it will call up your favorite file browser
  843. or archive viewer with the file loaded.  In File Mode, <CR> may be
  844. configured to duplicate the function of <G+>, although this is not
  845. recommended unless you really need it.
  846.  
  847. 4FILES comes configured with the internal 4DOS LIST command as the browser,
  848. but any browser can be used.  Shelling to DOS to run this internal
  849.  
  850.                                                                          16.
  851.  
  852. command is slow, but by using browse utilities like TV.COM, PC-Magazine'
  853. s free BROWSE.COM or Vern Buerg's LIST.COM, your file will be displayed
  854. in a literal eye-blink.
  855.  
  856. The <G+> and <^G+> commands recognize archive files if they are
  857. self-extracting (.EXE) files or if they have one of these extensions: .ZIP,
  858. .ARC, .DWC, .LBR, .LZH, .PAK or .ZOO.  When an archive is detected an
  859. archive viewer is called.  There are various types of archive browsers
  860. available.  FV.COM shows a simple listing of the contents.  ZR, LR, AR and
  861. ZOR not only show a listing (of ZIP, LHZ, ARJ and ZOO file respectively),
  862. but can view the text of files inside the archive and extract selected
  863. files from the archive.  These four programs can be found on BBSs as
  864. XRAY.ZIP or XRAY???.ZIP.
  865.  
  866.     4F-XRAY.BAT was provided with your copy of 4FILES to allow the most
  867. appropriate one of these five browsers to be called automatically via one
  868. 4FILES utility port.  If you use this batch file, it is best mapped to
  869. the <G+> key, and it is handy to then have FV mapped independently to the
  870. <G+> key.  4FILES comes with the <G+> mapped to FV and <^G+> mapped to
  871. ZR.COM.
  872.  
  873. While in browsers and other utilities, the mouse buttons work "as
  874. initialized" by 4FILES, and provides scrolling actions plus a quick return
  875. via the right button.  The combination of <left-button>=<G+> and
  876. <right-button>=<ESC>, combined with movement of the 4FILES cursor bar by
  877. the mouse, allows one handed "rapid-fire" inspection of multiple files.
  878. (Note: if you load 4FILES via SHROOM or call a utility with SWAPDOS, the
  879. mouse will be automatically disabled, temporarily.  This is necessary since
  880. the mouse handler gets overwritten.)
  881.  
  882. In the midst of your rapid firing though, you will sometimes inadvertently
  883. exit from 4FILES (even without the mouse).  To avoid this, you can
  884. reconfigure to disable quitting via the <ESC> key.  The <^ESC> and <@ESC>
  885. keys still function, and allow you to quit to the original or current
  886. directory respectively.  Improper <ESC> use will then display a menu of the
  887. proper keys.  If you use NEWKEY, to enable 4FILES to use the <^ESC> key,
  888. run NEWKEYSP.EXE, pick "I" on the menu, and make an entry for <^ESC>.
  889.  
  890.  
  891. EDITING FILES
  892. -------------
  893. <F2> calls your editor, loading it with the filename of the current
  894. record.  As supplied, editor access to .COM .EXE .BIN .OBJ .SYS .LIB .WKS
  895. .DB & .OVL extensions and the seven above archive extensions is denied.
  896. The denied extensions may be reconfigured.  Denials protect the integrity
  897. of non-text files.  A second editor or word processor (or any utility,
  898. such as a .GIF viewer) may be mapped to <^F2>.  The denied extensions
  899. apply to this key as well.  If a disk is write-protected, <F2> will give
  900. an error message.  If you have no editor, pick up PC-Mag's free TED.COM.
  901.  
  902. Note that an "R" switch is provided in the configuration listing for each
  903. utility port.  It forces reloading the current directory upon return from
  904. the utility, and should be "ON" for any editor or other utility which can
  905.  
  906.                                                                          17.
  907.  
  908. change file size or directory contents.  "W" (wait before redisplaying)
  909. should be off since you will want to return immediately from an editor.
  910.  
  911. To create a NEW file, hit <F2> while on a NON-FILE RECORD.  This will not
  912. work if the "R" switch is off.  You will be prompted for names for the new
  913. files, but may hit <CR> on the blank field blank if you wish.  Some editors
  914. may not be able to utilize more than one filename from the command line.
  915.  
  916.  
  917. FINDING DUPLICATE FILES
  918. -----------------------
  919. <F3> is initially set up to call a file finder utility called WHERE.EXE,
  920. loaded with the current file name.  Bruce Gavin's utility FIND.EXE is a
  921. good one to use here.  A utility of any type may be mapped to this key.
  922.  
  923.  
  924. UNZIPPING FILES
  925. ---------------
  926. <F4> is used to call an archive utility, such as 4UNZIP, a shareware
  927. utility  which in turn calls PKUNZIP, or SHEZ or XRAY.BAT.  A list is
  928. shown of the files archived in a .ZIP or other file archive, and files can
  929. be unzipped singly or in marked groups.  4UNZIP is important here since it
  930. will recover the file notes 4FILES archived with their files.  Note: the
  931. current 4UNZIP version causes a crash (immediately or a soon after use,
  932. with or without 4FILES) if certain keyboard buffer-expanders are used.
  933. Test your setup!
  934.  
  935. 4FILES will soon have a built-in routine which will replace 4UNZIP
  936. completely, and which will work on both ARJ and ZIP files (4UNZIP works
  937. only on ZIPs.  Some 4FILES users setup <F4> or <^G+>-Zip to call SHEZ, a
  938. comprehensive archiving tool (it's shareware).
  939.  
  940.  
  941. ====================
  942. UTILITY PORTS IN USE
  943. ====================
  944.  
  945. One potential difficulty which 4FILES avoids is that some utilities and
  946. editors you might like to call allow you to delete/rename files or change
  947. drives/directories.  When the utility is exited, 4FILES by default explic-
  948. itly changes back to its last drive/directory and rereads the directory
  949. list.  The bar is returned to the last record it was on, or if deleted, to
  950. the nearest record number possible.  This process takes a little longer
  951. than assuming that the directory structure is unchanged, and also destroys
  952. the "+/-" note-modified indicators and any file marks, but is SAFE.
  953.  
  954. Alternatively, you may tell 4FILES not to reload the directory by setting
  955. the "R" switch for the port to "N".  Use the "N" setting ONLY if you know
  956. the subject utility is not capable of the operations mentioned in the
  957. previous paragraph.
  958.  
  959. Note that the switch for the browser is also operative when displaying Help
  960. or this manual with <F1> or <^F1>, since the browser is used to display
  961. these files.  Two help files are provided: 4F.HLP and 4F.KEY.  The file
  962. 4FILES will call is 4F.HLP, so if you wish to use the other, rename both.
  963.  
  964.                                                                          18.
  965. ===============
  966. USING NOTE MODE
  967. ===============
  968.  
  969. ANNOTATING FILES
  970. ================  4FILES supports file notes (or "descriptions" in 4DOS
  971. parlance) up to 40-characters long, and each directory with annotated files
  972. will contain a hidden file named DESCRIPT.ION, containing the note data for
  973. all files in the directory.
  974.  
  975. Beginning with release 4.01, 4DOS can handle file notes up to
  976. 120-characters long, but 4FILES will not be able to use the extra
  977. capacity until a later release.  For now though, 4FILES does detect notes
  978. of over 40-characters and will warn you of the situation.  To limit
  979. creation of notes by 4DOS or other utilities to 40 characters, be sure
  980. that in your 4DOS.INI file the directive DescriptionMax=040 is set, which
  981. is the default setting.
  982.  
  983. File copying, moving, or renaming will however always work properly
  984. regardless of description length since 4FILES relies directly on 4DOS
  985. resources for these functions.  The only caveat is, again, that if a note
  986. has been edited, 4FILES will eventually rewrite DESCRIPT.ION, and only the
  987. first 40 characters of each note will be then be written.
  988.  
  989. To put the "*" character in a note, the SHIFT-8 key must be used since <G*>
  990. has a special function.
  991.  
  992. Great attention has been devoted to making 4FILES a true power tool for
  993. creating or modifying one or a multitude of notes.  These are the features:
  994.  
  995.  
  996. CUT & PASTE & NOTE DELETES
  997. ==========================  <F9> initiates the text-copying mode.
  998. Highlight the desired text by moving the cursor horizontally, and then hit
  999. <CR> to put it in the paste buffer.  <^F9> cuts  (rather than copying) the
  1000. text to the buffer, and <@F9> copies the whole note.
  1001.  
  1002. <F10> pastes text in the buffer at the cursor position.  If a PASTE
  1003. causes an overflow of the 40-character note space, the note is moved to
  1004. an 80-character space at the bottom of the screen.  This expanded field
  1005. is fully editable ( see following).  Captured text stays in the buffer
  1006. when changing drives or directories.  <F10> is inactive in FLR mode.
  1007.  
  1008. ^Y deletes the entire line.  In earlier versions it cut the line to the
  1009. cut- buffer, but now the buffer is loaded only via the various <F9> keys.
  1010.  
  1011. ^Y is functional in notes and all text input fields and command lines.
  1012.  
  1013. In Note Mode, ^D will delete the notes of all marked files.  As with file
  1014. deletion, a double-tap of the "Y" key is required to affirm the deletion.
  1015. The message is put on a different part of the screen than for file
  1016. deletion, to be sure you realize that you are deleting notes, not files.
  1017.  
  1018.                                                                          19.
  1019. EXPANDED EDIT FIELD
  1020. ===================  Expanded Field Mode is triggered whenever typing or
  1021. pasting causes the length of the current note to exceed 40 characters, and
  1022. allows editing over a full 80-character field.  The note is moved to a
  1023. highlighted 80- character field at the bottom of the screen and the
  1024. 40-character field is blotted out.  Two "eyebrows" of contrasting "blot"
  1025. characters, each 40-characters long, are placed above this field, and act
  1026. as a guide for where the over-long note will be truncated when <CR> or
  1027. <ESC> is hit. The effect of the blotted out 40- character field, eyebrows,
  1028. and highlighted bottom row is to draw your eyes down to the expanded field.
  1029.  
  1030. To return to the 40-character field, hit <ESC> or <CR>.  <ESC> will return
  1031. to the current record and <CR> moves the cursor to the next record.  In
  1032. both cases the note is truncated after the 40th character.  4FILES will
  1033. not accept more than 80 characters under any circumstances, and will block
  1034. any pasting or typing which would exceed that size.  A 40-character long
  1035. cut string can be pasted into a full 40-character note, since the expanded
  1036. field will be used for the overflow.
  1037.  
  1038.  
  1039. FLUSH RIGHT (FLR) MODE
  1040. ======================  To create notes which are easy to scan by eye, it
  1041. is sometimes useful to make part of a note left justified and part of it
  1042. right justified.  Hitting <Sh-Rt-Arrow> provides right justified text in
  1043. either of two ways:
  1044.  
  1045. 1. If there is text to the right of the cursor, it is bumped over to the
  1046. right margin.  The cursor is not moved, and 4FILES remains in its normal,
  1047. left justified editing mode.
  1048.  
  1049. 2. If there is no text to the right of the cursor, 4FILES enters Flush-
  1050. Right Mode (FLR).  The cursor is moved to the right margin, and highlighted
  1051. indicators are set-up to show the part of the note field which is available
  1052. for FLR text entry.  Text will grow leftward from the cursor, which is
  1053. initially outside the field.  Editing is forced into insert mode.  All
  1054. horizontal cursor movement keys are active.  ^Left & ^Right behave slightly
  1055. different than in normal mode, putting the cursor between words, and
  1056. Shft-BS is enabled.  Collision of new FLR text with any left-justified text
  1057. is prevented.  Cut and paste are not allowed.
  1058.  
  1059.  
  1060. QUITTING FLR MODE
  1061. =================  There are three ways to leave FLR mode, with differing
  1062. effects on the text cursor and the cursor bar.  In all cases, the
  1063. pre-existing insert or overwrite mode will be restored.  The choices:
  1064.  
  1065.         <ESC>            Leaves the cursor where it is.
  1066.         <Sh-Left>        Sends the cursor home.
  1067.         (Record-change)  (All vertical cursor keys act normally.)
  1068.  
  1069.  
  1070. INSERT / OVERWRITE MODES
  1071. ========================  The INSERT mode default may be changed from the
  1072. configuration menu.  The active mode may be toggled with <INS>.
  1073.  
  1074.                                                                          20.
  1075. ==============================
  1076. INTERNAL CONFIGURATION ROUTINE
  1077. ==============================
  1078.  
  1079. CUSTOMIZING 4FILES
  1080. ==================  You can change 4FILES' on-screen appearance, the
  1081. INSERT / OVERWRITE default, "utility port" setups, and a number of other
  1082. features.  <Alt-F10> displays the Main Configuration Menu, which offers
  1083. four Configuration Screen for action and <ESC> to quit.  If you edit the
  1084. configuration you will instead be given different quit options: (S)ession
  1085. only changes or (P)ermanent changes, which are saved to disk in a .CFG
  1086. file.  If you rename 4FILES, 4FILES will detect its new name and will
  1087. recognize only a .CFG file of the same name.  On exit from configuration,
  1088. new and old data are compared, and you are prompted to save the
  1089. configuration only if there is a difference.  When quitting 4FILES, you
  1090. will have an opportunity to save session-only configuration changes if you
  1091. like them.
  1092.  
  1093.  
  1094. "Utility Ports" Configuration Screen
  1095. ====================================
  1096. Each utility port shown has a Key/Function name which indicates the key to
  1097. access the utility and the recommended use for the port.  The first field
  1098. of each line is the "utility field", and is for an alias name, file name,
  1099. (filespecs) or a complete pathspec for a utility or application.  A
  1100. complete pathspec may speed loading, but is not necessary if the program
  1101. is in your PATH.  (DOS must know where to find the program, either from
  1102. the pathspec or by searching each directory listed in your system's PATH.)
  1103. A complete filespec can dramatically speed loading the utility, and is
  1104. recommended.  In all cases, a file extension MUST be given.  Valid
  1105. extensions include .BAT, .BTM and .ALS.  ".ALS" must be appended to
  1106. aliases or DOS internal commands.  .ALS is a flag for 4FILES, and is not
  1107. included in the actual call.  All commands without extensions will fail to
  1108. execute.
  1109.  
  1110. If you wish to swap 4FILES to EMS or XMS memory or a hard disk before
  1111. executing a utility or application, SWAPDOS.COM can be used.  Enter SWAPDOS
  1112. in the utility field.  The name of the program to be called then goes in
  1113. the tail ("T=") field, preceded by any command line switches for SWAPDOS
  1114. and followed by any of its own switches.
  1115.  
  1116. Another swap program which can be used for this is SHROOM.  4FILES rather
  1117. than the utility is loaded via SHROOM, so SHROOM should not be placed in a
  1118. port's configuration.  With SWAPDOS, swapping only occurs for the selected
  1119. utilities, while SHROOM will swap for all utilities and when shelling to
  1120. DOS.  On the other hand, SHROOM does fast executions via the DOS EXEC
  1121. function, while SWAPDOS makes a slower shell to DOS.  On any utility or
  1122. DOS calls in which SHROOM or SWAPDOS is active, the 4FILES mouse and
  1123. keyboard handlers are necessarily disabled during the call.
  1124.  
  1125. Errors in calling .COM and .EXE programs from 4FILES (e.g. file not found)
  1126. are shown as "configuration incorrect", but execution errors for batch
  1127. files and aliases are not trapped.  If execution is a quick flash on the
  1128. screen, you need to repeat the operation with a "screen pause" to see what
  1129. is happening. There are two ways to do this; one global and one specific to
  1130. the utility.  To pause after execution of all utilities and the DOS shell
  1131.  
  1132.                                                                          21.
  1133.  
  1134. (^E commands), set the "Pause after ^E" configuration switch to "Y".  To
  1135. cause a particular utility to pause after execution, set its  "H=" (hold
  1136. screen) switch to "Y".  There is also a "Pause after ^X" switch.
  1137.  
  1138. Displaying Help and this manual with <F1> and <^F1> (respectively) will
  1139. work only if the <G+> BROWSE key is configured correctly.
  1140.  
  1141. The next field in the utility-port block is the command line tail.  This
  1142. sends filenames, command line switches or other parameters to the utility.
  1143. "$F" inserts the current filename with extension, and may be placed where
  1144. needed among the parameters.  No spaces are needed before or after $F,
  1145. saving space. $P causes the full pathspec and filename to be inserted, and
  1146. is a good choice if you use Windows.  $N inserts the filename without its
  1147. extension.
  1148.  
  1149. The "H" field is a YES/NO field which determines whether or not 4FILES
  1150. waits for a keyhit after the utility has finished executing.  Set it to "Y"
  1151. for utilities which run straight through and exit without any user input.
  1152.  
  1153. The "R" field is also a YES/NO field which determines whether 4FILES
  1154. reloads the directory list and DESCRIPT.ION file after the utility exits.
  1155. It must be set to "Y" if the utility is capable of managing files or
  1156. changing drives and directories.  It should for example be "Y" for an
  1157. editor or word processor.
  1158.  
  1159.  
  1160. "Configuration Options" Screen
  1161. ==============================
  1162. This screen provides switches, grouped into sections, for the following:
  1163.  
  1164.  
  1165. KEYBOARD/MOUSE SWITCHES:
  1166. ------------------------
  1167. International Keyboard Code:
  1168.    -- Two letter DOS keyboard-country-code.  LEAVE THIS BLANK UNLESS YOU
  1169.       HAVE A PROBLEM.  Takes effect next session.
  1170.  
  1171. Keyboard Type:
  1172.    -- "1" = AT keyboard, <G*>, <G->, <G+> keys active.
  1173.       "2" = PC keyboard, substitutes <Scl-Lock> for <G*>.
  1174.       "3" = Laptop.  Substitutes <[>, <]>, and <ENTER> for above.
  1175.  
  1176. Overtype Default?
  1177.    -- The INSERT mode default can be changed to OVERTYPE.  The default
  1178.       state has the line cursor, the alternate state has the block cursor.
  1179.  
  1180. Disable QUIT via <ESC>?
  1181.    -- To avoid inadvertent exits via <ESC> set this to "Y" and exit with
  1182.       <^ESC> or <@ESC>.  If you use NEWKEY, see P.10. In MS-Windows and
  1183.       OS/2 setting this switch allows task switching to occur.
  1184.  
  1185. Substitute <CR> for <G+> Key in File Mode?
  1186.    -- "Y" substitutes the <Enter> (<CR>) key for the <G+> key, in File Mode
  1187.       only.  <CR> retains its text writing meaning in Note Mode.
  1188.  
  1189.                                                                          22.
  1190. Let 4FILES Enable the Mouse?
  1191.    -- "N" leaves the mouse set up as-received by 4FILES.  "Y" causes 4FILES
  1192.       to install its own mouse handler.  Takes effect in next 4FILES
  1193.       session.
  1194.  
  1195.  
  1196. VIDEO SWITCHES:
  1197. ---------------
  1198. Video Mode (hex), Alternate #:
  1199.    -- Spaces are provided for three extended video modes, and these must be
  1200.       hex numbers from your video card manual.  If these fields are blank,
  1201.       BIOS methods will be used to switch video modes on EGA and VGA
  1202.       monitors.  Providing numbers here may provide better performance or
  1203.       more preferable fonts.
  1204.  
  1205. Use Snow Prevention if CGA?
  1206.    -- Set to "Y" if your CGA monitor has a snow problem.
  1207.  
  1208. At Exit & Shell: Enable Blinking?
  1209.    -- 4FILES disables blinking to allow all color choices.  To restore
  1210.       blinking on exit and during utility calls, set this to "Y"; otherwise
  1211.       blinking is left off.
  1212.  
  1213. At Exit: Use 4FILES Colors in DOS?
  1214.    -- "Y" leaves the screen set to the 4FILES text color at exit; otherwise
  1215.       the DOS color is restored.  (Not recommended if ANSI is active since
  1216.       screen scrolling will give patches of DOS colors.)
  1217.  
  1218.       POTENTIAL CONFLICT IF BLINKING IS LEFT OFF:  If this switch and the
  1219.       previous one are both set to "Y" and you use a high-intensity or dark
  1220.       grey text background, poorly behaved programs you run after 4FILES may
  1221.       show unexpected colors. Areas these programs intend to blink will not
  1222.       blink and will be shown in an arbitrary color.  This is not a problem
  1223.       with 4FILES.  The Utility Ports Configuration Menu now has a blink
  1224.       enable switch for each port, to avoid this problem when calling such
  1225.       utilities from within 4FILES.
  1226.  
  1227.       IF BLINKING IS LEFT ON:  If this switch is "Y," AND you will exit with
  1228.       blinking enabled, AND your 4FILES text background is dark grey or high
  1229.       intensity, something has to give and the exit will be to DOS colors --
  1230.       otherwise your entire screen might flash, depending on the background
  1231.       you are using.
  1232.  
  1233. At Exit: Show Previous DOS Screen?
  1234.    -- Determines whether the 4FILES screen is left showing at exit or
  1235.       whether the previous DOS screen is shown.  The later will not work
  1236.       unless you have a TEMP directory designated in your environment.
  1237.  
  1238.  
  1239. SHELLING OPTIONS:
  1240. -----------------
  1241. Prompt before Copy/Move Overwrite?
  1242.    -- Determines whether duplicate filenames found in the target directory
  1243.       will be automatically over- written or whether you will prompted to
  1244.       quit or continue.
  1245.  
  1246.                                                                          23.
  1247. Use Copy/Move Alias?
  1248.    -- "N" is the default.  Use __CAUTION__ if you change this.  "Y"
  1249.       disables 4FILES' protection against trashing a file if you specify a
  1250.       non-existent directory during a marked files copy/move.  If set to
  1251.       "Y" your aliases for both Copy and Move must provide this protection.
  1252.  
  1253. Run COPY/MOVE/RENAME Full Screen?
  1254.    -- For best appearance, set this to "Y" and see if your video system will
  1255.       work properly with the smaller window provided.  4FILES sets up the
  1256.       window and DOS then runs within it.  "Y" works for most systems.
  1257.  
  1258. Run Archivers on a Full Screen?
  1259.    -- Similar to the above, providing separate control for windowing of file
  1260.       archiving operations.
  1261.  
  1262. Pause After ^E DOS Commands?
  1263.    -- If the result of an (^E)xecute flashes off screen, set this to "Y", or
  1264.       alternatively enter "++" at the end of the ^E command input line.
  1265.       Both await a keyhit.
  1266.  
  1267. Pause After ^X or <F9> Program Runs?
  1268.    -- This prevents the result of an immediate execution from flashing off
  1269.       screen, as above.
  1270.  
  1271.  
  1272. OTHER OPTION SWITCHES:
  1273. ----------------------
  1274.  
  1275. Never Save File Marks on Exit?
  1276.    -- If you don't intend to use the /M command line switch, setting this to
  1277.       "Y" will avoid writing DEMARCAT.ION files unnecessarily.
  1278.  
  1279. Never Save File Marks on Directory Change?
  1280.    -- If you don't care to have your file marks retained during a session,
  1281.       setting this to "Y" will avoid writing DEMARCAT.ION.
  1282.  
  1283. AT STARTUP: Read Old File Marks?
  1284.    -- If the switch two above is set to "N," setting this switch to "Y" will
  1285.       cause file marks from a previous session to be shown.
  1286.  
  1287. AT STARTUP: Show File Attributes?
  1288.    -- Normally 4FILES starts up with the file time shown  field displayed.
  1289.       This switch causes file attributes to be shown instead.  (<F7> toggles
  1290.       the display during a 4FILES session.)
  1291.  
  1292. AT STARTUP: Start in Note Mode?
  1293.    -- 4FILES is normally started in File Mode, but you may change that here.
  1294.  
  1295. Beep Turned On?
  1296.    -- 4FILES is supplied with this set to "Y."
  1297.  
  1298.  
  1299. Further note on the "Use Copy/Move Alias?" Switch
  1300. -------------------------------------------------
  1301. Use of this switch is not recommended, but is provided for power
  1302. users.  It should normally be set to "N".  It determines whether an
  1303.  
  1304.                                                                          24.
  1305.  
  1306. existing 4DOS command or user alias named COPY, MOVE or RENAME will be
  1307. unaliased before sending the command.  NOTE THAT ENABLING ALIASES DISABLES
  1308. THE SAFETY IN 4FILES WHICH PREVENTS MARKED FILES FROM OVERWRITING ONE
  1309. ANOTHER IF THE TARGET DIRECTORY DOES NOT EXIST.  You MUST incorporate this
  1310. safety yourself into BOTH the copy and move aliases you use, for example
  1311. by including the 4DOS /D switch.  The 4FILES switch is provided to
  1312. support users who have aliases which complete a path fragment (given for a
  1313. copy/move operation) into a full path.  If 4FILES were totally safe for
  1314. both switch settings, such aliases would be pre-empted by the prompt to
  1315. create the non-existent target directory, which is what a path fragment
  1316. appears to be.  The switch is completely safe if set to "N."  If set to
  1317. "Y," you must take the above precautions.  Also, if set to "Y" your
  1318. aliases must be able to handle (either using or discarding) both the /R
  1319. and /P switches.
  1320.  
  1321.  
  1322. "Configure Colors & Highlights" Screen
  1323. ======================================
  1324.  
  1325. The screen itself does not truly portray the 4FILES colors (so that the
  1326. location of input fields can be clearly shown), so a sample screen is
  1327. shown at the bottom of the screen.  Just follow the instructions on the
  1328. screen.  Since 4FILES turns screen blinking off, monochrome highlights
  1329. and background colors not normally available (i.e. dark grey) may be
  1330. used.  If dark grey is used, you will probably want to set the "Enable
  1331. Blinking" switch to "N."
  1332.  
  1333. Some color combinations may not work with some "ported utilities".  For
  1334. example, if a utility automatically sets up a black on white cursor bar
  1335. without clearing the screen to white on black text first, AND if you have
  1336. 4FILES text set to black on white, you won't see the cursor bar.   This
  1337. occurs with 4UNZIP & VDE.COM.  The only solution is to pick text colors for
  1338. 4FILES which avoid the conflict.  Please write to authors of such programs
  1339. and request a "smarter" set up of screen attributes in the next version.
  1340. Please notify me as well, and I will contact them too.
  1341.  
  1342.  
  1343. ================
  1344. DISPLAY FEATURES
  1345. ================
  1346.  
  1347. 4FILES works with any video text mode of 80x25 or higher.  At startup 4FILES
  1348. automatically detects the display type and acts appropriately.  During your
  1349. 4FILES session you may quickly alternate between three or four video modes
  1350. using the Ctrl-<F7> key, if you have an EGA or VGA monitor.  More about
  1351. this in a moment.
  1352.  
  1353. At startup, except for HGC, MDA and CGA video cards, if a higher mode is
  1354. used it will be automatically implemented.  For HGC, MDA and CGA running
  1355. higher modes (such as with UltraVision), the /+ command line switch must be
  1356. used. The reason is that not all cards in this class are 100% BIOS
  1357. compatible, in some cases defeating the automatic detection, and this
  1358. arrangement assures that all systems will run " out of the box" in 80x25
  1359. mode.  When calling 4FILES from an application running a higher mode, 80x25
  1360.  
  1361.                                                                          25.
  1362.  
  1363. mode may be forced with the /8 switch.  When calling utilities or shelling,
  1364. the screen may look its best (depending on your color choice) if ANSI.SYS
  1365. is not loaded.
  1366.  
  1367. If a CGA video card is detected, a no-snow video writing method is used by
  1368. default.  For faster displays, this method may be configured "off".
  1369.  
  1370. Video mode switching is useful for displaying a longer list in fine type
  1371. or a shorter list in more readable type.  There are two ways to achieve
  1372. video mode switching using the Ctrl-<F7> key.
  1373.  
  1374. Method 1:  By default, BIOS methods are used to alternate between a 25, 43
  1375. and 50 line display.  (There is no 50-line mode for EGA.)
  1376.  
  1377. Method 2:  This method usually gives superior results, and is activated by
  1378. specifying extended video modes on the Configuration Options Menu.  If these
  1379. fields are blank, Method 1 will be used.  The numbers you provide should be
  1380. found in the manual for your video card, are specific to your hardware, and
  1381. must be hexadecimal values.  You may toggle between the three (or fewer)
  1382. specified modes and the mode you were in at startup (i.e. four modes to
  1383. choose from).  There is one case for which Method 2 will default to Method
  1384. 1, and that is if when starting 4FILES, MODE CON LINES = nn had been used
  1385. to set up a 43 or 50 line mode in DOS.
  1386.  
  1387.      Rules for Method 2: 1> The extra modes must use at least 80 columns.
  1388.      2> You cannot switch between color and monochrome modes.  3> The new
  1389.      modes listed must be supported by your video card -- consult your
  1390.      video card manual for proper hex values.
  1391.  
  1392.  
  1393. WHAT YOU SEE ON-SCREEN
  1394. ----------------------
  1395. "T" and "E" indicators near the top and bottom of the screen indicate that
  1396. the top or end of the listing is shown on screen.  Used disk bytes are
  1397. shown in File Mode, and the 4FILES version number is shown in Note Mode.  A
  1398. file count is displayed at all times.  An "S" indicator with an up arrow
  1399. symbol on the top row means the file search direction is upward; if there
  1400. is no symbol shown the direction is downward.  "PROTECTED" and "ROOT FULL"
  1401. messages indicate that the full range of file management and note editing
  1402. features are not available for the current disk.  "Protected" means the
  1403. disk is write protected.
  1404.  
  1405. Records with altered notes are flagged with a "+/-" character at mid-line.
  1406. A different character is shown for unaltered notes.  A "delta" character
  1407. next to a filename means the file is marked for group file management.
  1408.  
  1409.  
  1410. ===================================
  1411. OPERATING WITH SPECIAL ENVIRONMENTS
  1412. ===================================
  1413.  
  1414. RUNNING UNDER MS-WINDOWS
  1415. ========================  4FILES runs well as a non-Windows application.
  1416. Windows is detected automatically, and regardless of the 4FILES
  1417. configuration setting for the ESC key, the CTRL-ESC and ALT-ESC keys will
  1418.  
  1419.                                                                          26.
  1420.  
  1421. serve their Windows functions.  In Windows, <ESC> or <Shift-ESC> are used
  1422. to terminate 4FILES.
  1423.  
  1424. Note that the mouse will work in 4FILES only when 4FILES is in a full
  1425. screen window -- when the program is in a window, the Windows mouse
  1426. handler is operative.  As you should know, you may toggle between windowed
  1427. and full screen with the Windows <Alt><Enter> key.  The 4F.PIF file
  1428. provided will cause 4FILES to startup in a window, but you may change this
  1429. behavior.
  1430.  
  1431. This is the recommended way to install 4FILES in Windows:
  1432.  
  1433. 1) It is best to have two 4FILES installations; one in the Startup Group
  1434. which will always be loaded automatically into a minimized-icon or window
  1435. whenever you load Windows, and one in whichever Group is normally
  1436. showing on your desktop.  This will give one example of how to do this.
  1437. Your DOS installation of 4FILES should be completed before proceeding.
  1438. Be sure 4F-I-WIN.ICO and 4F-P-WIN.PIF are in the same directory as the
  1439. program, or alternately put copies of them in your Windows directory.
  1440.  
  1441. 2)  Open the Startup Group.  From the Program Manager menu line select
  1442. "File," then "New" and "OK" with "Program Item" selected.  You are now in
  1443. the Program Properties dialog box.  Type in 4FILES as the description,
  1444. then <TAB> to the next field and use the mouse to select the "Browse"
  1445. button.  Use the directory tree to find your way to the copy of 4FILES
  1446. installed for DOS, and select 4F.COM.
  1447.  
  1448. 3)  The selection takes you back to Program Properties.  <TAB> to the
  1449. Working Directory field and type in the drive and directory you want
  1450. 4FILES to list when it starts up.  <TAB> to the next field and type the
  1451. hot-key combination you wish to use to reopen the 4FILES window.  Finally,
  1452. if you do not wish 4FILES to load immediately (remember, this is the
  1453. Startup Group) and prefer to have it appear instead as an icon at the
  1454. bottom of the screen, set the "Run Minimized" box.  Open the dialog box
  1455. menu (upper left corner button), save your setup and then exit.
  1456.  
  1457. 4)  Now open the Windows PIF Editor.  Open its menu, and cascade through
  1458. the "File" and "Open" choices.  Use the tree to find the directory with the
  1459. copy of 4FILES that you are installing, and select 4F-WIN.PIF.  You are
  1460. returned to the previous dialog box, and the fields have been filled from
  1461. the .PIF file.  The "Startup Directory" field here will be over-ridden by
  1462. the "Working Directory" entry you made earlier from Program Properties.
  1463. Make the Display Usage choice to determine whether 4FILES will start up
  1464. full-screen (with 4FILES mouse operational) or in a window (with mouse
  1465. Windows mouse operational).  Remember, you can toggle between the display
  1466. types and type of mouse operation with <Alt><Enter> at any time.  Save
  1467. your work, and exit from PIF Editor.
  1468.  
  1469. If you ever create your own .PIF, set the KB Required to 128K.  Although
  1470. 4FILES is a .COM file, it needs memory for 64K of data in addition to its
  1471. own code and buffers, which is also approaching 64K.  Set KB_Desired to
  1472. 640K, to leave room for utilities called from 4FILES.
  1473.  
  1474.                                                                          27.
  1475.  
  1476. 5)  It is recommended that you do a duplicate installation in the Windows
  1477. Group you will normally have showing on your desktop.  This way, if you
  1478. terminate 4FILES you will have another icon at hand for loading again
  1479. without the bother of opening the Startup Group to find it.
  1480.  
  1481. Using 4FILES in Windows
  1482. -----------------------
  1483. For regular 4FILES use (except during evaluation under COMMAND.COM) be sure
  1484. your COMSPEC environment variable specifies 4DOS or NDOS.  To use the mouse
  1485. in 4FILES, your mouse driver MUST be loaded prior to loading Windows.
  1486. Although Windows does not need a pre-loaded driver, 4FILES does.  The
  1487. mouse will have its 4FILES functions when 4FILES is running full screen,
  1488. and will have its Windows functions when 4FILES is in a window.  You may
  1489. toggle 4FILES between full screen and window displays with <Alt><Enter>.
  1490.  
  1491. <Alt><ESC> will swap out of 4FILES to other tasks.  When the swap cycle
  1492. comes back to 4FILES, if 4FILES is running full screen, you will come
  1493. back to the 4FILES icon and will have to reopen it.  If it is running in
  1494. a window though, you will come back to your place on the 4FILES screen, or
  1495. the screen of a utility you may have called from 4FILES and been in when
  1496. you swapped tasks.  4F-WIN.PIF sets the Windows short-cut to Alt+CAPSLOCK;
  1497. this may be changed on the PIF-Editor "Advanced" screen.
  1498.  
  1499. One handy use of 4FILES is to have it in a background window that has an
  1500. edge or corner showing.  Suppose you are in a Windows application, for
  1501. example PageMaker, and you are looking at a directory list, trying to
  1502. decide which file to load.  The Windows directory display does not show
  1503. file notes or allow you to view a file, and it can be hard to figure out
  1504. which file you want.  Just click on the 4FILES window to bring it to the
  1505. foreground, change to the same directory, and read your notes.  Then click
  1506. on the window for your application, and you are ready to go.  Of course,
  1507. with the 4FILES window handy in the background it is also easy to update
  1508. your file notes after creating or editing a file with another application.
  1509.  
  1510.  
  1511. RUNNING UNDER OS/2
  1512. ==================  Users report that 4FILES runs well in an OS/2 2.0 VDM.
  1513. The author does not yet have OS/2, and has not fine-tuned 4FILES for oper-
  1514. ation under it, other than using Alt-ESC & Ctrl-ESC as above.  Suggestions
  1515. for use under OS/2 are welcome.  An OS/2 icon is provided.  In Presentation
  1516. Manager, OS/2 converts 3-button mice to 2-button action, unfortunately.
  1517.  
  1518.  
  1519. RUNNING UNDER DESQVIEW
  1520. ======================  4FILES is now DESQview (DV) aware, and may be
  1521. used in  small or full windows.  Note that even though 4FILES is fully
  1522. DV-aware, " Writes directly to screen" must be set to "yes" since
  1523. utilities you call from 4FILES may not be DV-aware.  DV's Transfer and
  1524. Learn functions are fully functional, even though 4FILES does employ its
  1525. own keyboard handler. 4FILES' time slice will be released while 4FILES
  1526. is idling.
  1527.  
  1528. Sufficient memory must be allotted to 4FILES for itself plus the largest
  1529. utility (or the DOS secondary shell) which will be called from within it.
  1530. You may wish to have "Open" menu entries for a few copies of 4FILES, each
  1531.  
  1532.                                                                          28.
  1533.  
  1534. with a different name and its own .CFG file.  For example, one copy might
  1535. be setup to call TED (a small freeware text editor) as the editor so 4FILES
  1536. can be fully functional with minimal memory requirements; and another copy
  1537. might call Multi-Edit (a full featured editor) and be set up for 350+K of
  1538. memory.  Due to 4FILES' small size it is realistic to use multiple copies
  1539. (each with its own .CFG file) to provide this flexibility.
  1540.  
  1541. When setting up for 4FILES it is suggested that the filename plus extension
  1542. be used, causing DV to load 4FILES directly itself rather than calling DOS
  1543. to load it.  This  saves  several K of memory and saves  much time during
  1544. utility calls since execution will be  direct.  On utility calls if  DOS
  1545. loaded 4FILES, DV will shell to DOS before the  utility is loaded.  Also,
  1546. if a utility is called while 4FILES is in a small window, the utility's
  1547. screen may appear to be blank and unscrollable, depending on the location
  1548. of text on the page.  In this situation just zoom the window to full size.
  1549.  
  1550. In the DV setup for 4FILES, set "Uses it's own colors" to yes, but don't
  1551. use colors which interfere with blinking.  For  example, when dark grey is
  1552. used for the 4FILES list background, 4FILES  will  display correctly but
  1553. when you switch to another window the whole 4FILES window will blink.  Some
  1554. monochrome highlight choices have this same effect.
  1555.  
  1556. Under DESQview the 4FILES CTRL-ESC and ALT-ESC keys loose their meaning
  1557. since 4FILES will always load showing its home directory.  These keys can
  1558. still be useful though, allowing "plain" ESC to be deactivated as
  1559. described herein.
  1560.  
  1561.  
  1562. ===============
  1563. SAFETY FEATURES
  1564. ===============
  1565.  
  1566. DISK OVERFLOW PREVENTION
  1567. ========================  In DOS, a file write that exceeds disk capacity
  1568. truncates the file, usually with no immediate outward indication of a
  1569. problem.  Automatic protection against such data loss must be provided by
  1570. the  program itself, and 4FILES is so equipped.  Competing programs do not
  1571. check for disk overflow; some simply truncate the file, and some truncate
  1572. it to zero length.  Some give absolutely no warning, and others warn only
  1573. after the damage is done.
  1574.  
  1575. Whenever you change records or directories, 4FILES checks for an over-flow
  1576. condition.  If your edits exceed disk capacity, you are immediately alerted
  1577. with a message giving the number of excess bytes.  At this point the note
  1578. file is still in memory, and operations which would cause a file write
  1579. are blocked.  These include drive or directory changes, calling browse or
  1580. edit utilities, and quitting.  Meanwhile, you have FULL editing freedom,
  1581. even text insertion and pasting, while editing your notes down.
  1582.  
  1583. The overflow bytes message is updated on each record change, and the byte
  1584. tally can run up as high as necessary.  When the message stops appearing,
  1585. the notes will then fit on disk and blocked-off functions are re-enabled.
  1586.  
  1587.                                                                         29.
  1588.  
  1589. Entirely deleting a note deducts more than the note size from the overflow;
  1590. the length of the "filename.ext" plus three delimiter bytes are also
  1591. nixed.  If you delete a file (as opposed to just its note) or subdirectory
  1592. with the D or K commands, the space freed up from the record and its note
  1593. will be properly accounted for.  Changes during ^E operations are
  1594. accounted for also since the directory is always reread afterward.
  1595.  
  1596. 4FILES pinpoints available disk space down to the last byte.  In one
  1597. unusual circumstance the overflow detection behavior may seem strange,
  1598. although it is still working correctly.  Writing a  new file requires at
  1599. least one cluster of disk space (1024, 2048, or 4096 bytes, depending on
  1600. the drive). Writing the first note in a subdirectory requires one cluster
  1601. of available space, but if the disk is already full, doing so will cause an
  1602. overflow condition.  You might try going to another subdirectory that has
  1603. notes and deleting a few notes, but this probably will not work.  You may
  1604. appear to free up enough bytes, but unless this also frees up a cluster
  1605. 4FILES will still indicate an overflow since one does in fact exist.
  1606.  
  1607. Unmarking files may also reduce disk requirements, especially if all files
  1608. are unmarked, freeing up a whole cluster.
  1609.  
  1610.  
  1611. READ ONLY "TRAP" AVOIDED
  1612. ========================  4DOS and 4FILES can move and edit notes only if
  1613. the "attribute" of the DESCRIPT.ION file allows a file write.
  1614. Unfortunately, the "READ-ONLY" attribute can be inadvertently set by some
  1615. utilities, especially those which can operate on blocks of files (such as
  1616. XTREE Pro).  When loading a directory, 4FILES checks ahead for the
  1617. READ-ONLY attribute, and will prompt you to clear it.  Competing programs
  1618. aren't so nice.  They let you edit notes and appear to save your notes to
  1619. disk -- but ... uh, uh, surprise!  Your work is gone.  4FILES won't let
  1620. you waste effort making edits which can't be saved, nor will it lose them
  1621. under any circumstances.
  1622.  
  1623. If you say "NO" to clearing the attribute during a directory change, you
  1624. return to the old directory.  During 4FILES startup, picking "NO"
  1625. terminates the program. "YES" clears the bit, and operations are normal.
  1626. NEVER intentionally mark a DESCRIPT.ION file "READ-ONLY" for any reason.
  1627. 4FILES catches the error, but 4DOS  doesn't check for it.  As a result, a
  1628. file moved or copied TO the affected  directory will lose its note.  A
  1629. file in that directory will lose its note if it is renamed.
  1630.  
  1631. 4FILES also will not allow you to use the A or ^A commands to change the
  1632. attributes of DESCRIPT.ION, nor will it allow you to copy or rename it.  It
  1633. may be deleted only if all notes have been erased.  Such protections are
  1634. essential to the safety of the description system.
  1635.  
  1636.  
  1637. TIMELY INACCESSIBLE-DISK DETECTION
  1638. ==================================  Files on a write protected disk
  1639. cannot be altered, and if the root directory is full, files can't be
  1640. added to it. During 4FILES startup and all drive or directory changes an
  1641. immediate check is made to see if one of those conditions exists.  If so,
  1642. you will be alerted with a prominent "PROTECTED" or "ROOT FULL" message.
  1643. As appropriate, certain 4FILES functions are disabled, and you will get
  1644.  
  1645.                                                                         30.
  1646.  
  1647. an error message if you try to use them.  For example, in a full root you
  1648. will not be able to edit notes unless the DESCRIPT.ION file already
  1649. exists.  You can view files on a protected disk, but file management and
  1650. note editing is impossible. No wasted time writing notes you can't save!!
  1651.  
  1652.  
  1653. INTERNAL CRITICAL ERROR HANDLER
  1654. ===============================  DOS handles some simple, common problems
  1655. as critical errors, and can disrupt execution of a program.  These problems
  1656. include leaving a drive door open or calling a drive with no disk inserted.
  1657. 4FILES has its own INT24 handler to treat such problems seamlessly.  It
  1658. also goes to extra effort to handle use of drives A and B in single floppy
  1659. systems seamlessly.
  1660.  
  1661.  
  1662. ===========
  1663. 4FILES TIPS
  1664. ===========
  1665.  
  1666. Here are some ideas for making the most of 4FILES in everyday use.
  1667.  
  1668. 1) TEAMWORK WITH LARGE APPLICATIONS #1:  4FILES is a real time saver when
  1669. used in conjunction with some application programs.  For example, you can
  1670. write a 4DOS alias which loads 4FILES whenever you exit your comm program.
  1671. Using Procom as an example, if you create this 4DOS/NDOS alias:
  1672.  
  1673.        ALIAS COM = C:\COM\PROCOM ^ 4FILES C:\COM\DOWN /T/D
  1674.  
  1675. the command "COM" will cause 4FILES to be load when Procom exits.  Your
  1676. download directory will be shown sorted in reverse order by file creation
  1677. time, placing new files at the top.  Alternatively, using /E/D would put
  1678. .ZIPS at the top.  Then, using <G+> you may view the contents of the new
  1679. text or .ZIP files.  To unzip a file, type F4 to call PKUNZIP or 4UNZIP.
  1680.  
  1681.  
  1682. 2) TEAMWORK WITH LARGE APPLICATIONS #2:  In Windows or OS/2, keep a corner
  1683. of the 4FILES window visible in the background where it is immediately
  1684. accessible.  Use 4FILES to refer to your file notes when you are having
  1685. trouble deciding which file to load into a Windows application from the
  1686. "sparse" directory lists Windows provides.  This also keeps 4FILES handy
  1687. for quick file note updates when you created or modify data files.
  1688.  
  1689.  
  1690. 3) MORE ROOM FOR BIG APPLICATIONS:  To make more room for big applications,
  1691. you can use SHROOM or SWAPDOS to swap 4FILES to EMS or XMS memory or disk.
  1692. Use of these programs is described elsewhere in this manual.  The freed-up
  1693. memory may make the difference between your application running or not
  1694. running.
  1695.  
  1696.  
  1697. 4) MULTIPLE 4FILES CONFIGURATIONS: You can write a variety of aliases to
  1698. quickly load 4FILES in specialized, frequently used configurations.  An
  1699. alias called 4E might call 4FILES with the /E switch set.  Another called
  1700.  
  1701.                                                                         31.
  1702.  
  1703. 4T, might make the call 4FILES C:\WP\TEXT.  In such aliases, giving the
  1704. full pathspec to 4FILES will speed loading, or you may want to have the
  1705. directory containing 4FILES listed early in your PATH statement.
  1706.  
  1707.  
  1708. 5) SPEED YOUR RETURN AFTER SHELLING TO DOS: use this alias: ALIAS = E EXIT.
  1709. Then "E <CR>" gets you back to 4FILES (or other shelling program) fast from
  1710. the secondary shell.
  1711.  
  1712.  
  1713. 6) REMEMBER THE "DOUBLE-TAP" KEYS:   ^E^E, < G**>, and the double strokes
  1714. to quit the Sort menu.  Also <G***> to return to the previous directory.
  1715.  
  1716.  
  1717. 7) FREEZING THE SCREEN #1: With the ^E command or when using a utility
  1718. port with a batch file or alias, a message might flash off screen too fast
  1719. to read, or it might appear that nothing happens at all.  Appending a "++"
  1720. to the command will freeze the screen after execution until a key is hit,
  1721. allowing you to see what happened.  Also, 4FILES can be configured to pause
  1722. after every execution.
  1723.  
  1724.  
  1725. 8) FREEZING THE SCREEN #2: Some utilities you may like to use will scroll
  1726. several pages right off the screen.  The solution is to call an alias, as
  1727. in these examples calling Borland's TDUMP.  They are most conveniently
  1728. placed in an alias file, but can be entered on the command line if the
  1729. alias expansion is enclosed in single quotes (once entered they are in
  1730. memory, ready for use).  "=" is not needed from the command line.
  1731.  
  1732.         ALIAS HEX=C:\PROG\TDUMP.EXE %1-h | MORE
  1733.     or  ALIAS HEX=C:\PROG\TDUMP.EXE %1-h | C:\UTIL\LIST.COM /S
  1734.  
  1735.     The first example pipes to an MSDOS resource which pauses at the end of
  1736. each page.  The later pipes output into Vern Buerg's LIST program, which
  1737. allows back and forth scrolling through the output.  To put this to heavy
  1738. use, map "HEX.ALS" to the 4FILES F3 key.  (This is just an example; it is
  1739. really more efficient to use LIST.COM's ability to do a hex dump directly
  1740. by configuring <G+> or <F3> to call it with $F/h in the command tail.)
  1741.  
  1742.  
  1743. 9) OPTIMUM KEYBOARD: We all get set in our ways so it may take some
  1744. adjustment, but if your function keys are across the top, getting a
  1745. keyboard with F-keys on the left will REALLY speed up your work in all
  1746. programs and make it more accurate.  In 4FILES the proximity of these keys
  1747. to <ESC>, <TAB>, <CTRL> and <ALT> is handy, especially when marking/
  1748. unmarking all files with ^F5 and ^F6. My switch to such a keyboard was VERY
  1749. rewarding!
  1750.  
  1751.     If you have a laptop computer, be sure to select KeyboardType=3 from
  1752. the Configuration Options screen.  Also, check out the separate cursor
  1753. keypad units described above under "Directory Navigation".
  1754.  
  1755.                                                                         32.
  1756.  
  1757. 10) FAST LOADING OF CALLED UTILITIES:  On the configuration screen,
  1758. provide the full pathspec and filename for each utility, rather than
  1759. relying on DOS to search for the program in your PATH.  Your utilities
  1760. will load in the blink of an eye; relying on PATH you will probably notice
  1761. at least some delay, and perhaps a lot if the directory holding the
  1762. program is deep in your PATH.
  1763.  
  1764.  
  1765. 11) COLOR SUGGESTION FOR COLOR MONITORS:  As supplied 4FILES displays
  1766. in colors that won't interfere with screen blinking.  Through experiment-
  1767. ation I have come up with two other color schemes which I feel are easier
  1768. on the eyes, as well as being functional.  In particular, they give a good
  1769. balance between the color of the cursor bar and the colors of both normal
  1770. text and sorted fields.  The best one uses a dark grey background, which
  1771. may require switch adjustments on the 4FILES configuration menu if you
  1772. have blinking troubles with utilities which are called from 4FILES (the
  1773. same attribute bit can mean "dark grey" or "blinking character" depending
  1774. on whether the blink-enable bit is turned on or off in the BIOS -- and
  1775. some programs fail to set this bit to the state they need to have it in).
  1776.  
  1777.                            COLOR SET #1               COLOR SET #2
  1778.                     -------------------------    -----------------------
  1779.     FIELD         || BACKGROUND   CHARACTER   || BACKGROUND   CHARACTER
  1780.     ------------- || ----------   ----------- || ----------   ----------
  1781.     NORMAL TEXT   || Dark  Grey   Dark Green  || Black        Dark Cyan
  1782.     SORTED FIELD  || Dark  Grey   Light Yell  || Black        Light Yell
  1783.     CURSOR BAR    || Light Grey   Black       || Light Grey   Black
  1784.     CUT HI-LIGHT  || Dark  Red    Black       || Dark  Grey   Light Red
  1785.     FUNCTION KEY  || Dark  Grey   Light Grey  || Light Grey   Black
  1786.     MENU TEXT     || Dark  Grey   Dark  Cyan  || Black        Rust
  1787.     INDICATORS    || Dark  Red    Light White || Dark  Red    Light Grey
  1788.  
  1789.  
  1790. ====================================
  1791. 4FILES ... ORIGIN & FUTURE EVOLUTION
  1792. ====================================
  1793.  
  1794. 4FILES is coded entirely in assembly language for high speed and small
  1795. size; consequently the work involved has been considerable, and the
  1796. job isn't even done.  The code was written entirely in-house and totals
  1797. over 800K and about 25,000 lines of code.
  1798.  
  1799. The concept arose from the lack in 4DOS of two things.  1)  4DOS has no
  1800. good means to create or edit the file notes it otherwise handles so well,
  1801. and its internal note editor is basic and frustrating to use.  2) while
  1802. 4DOS has its own internal transfer commands (COPY, MOVE and RENAME) which
  1803. automatically keep notes with their files, it does not have a good way to
  1804. perform these operations on marked groups of files.  4DOS unaware
  1805. utilities capable of marked file operations (such as XTREE-PRO) are
  1806. however also unsatisfactory, since they are oblivious to file notes and
  1807. will trash them.  4FILES was designed as a tool to do all of these things
  1808. and more, such as zipping file notes into the archive with their files.
  1809. In addition, every file manager I tried left much to be desired in terms
  1810. of efficiency from the user's viewpoint.  A simple interface packing a lot
  1811. of power has been my goal.
  1812.  
  1813.                                                                         33.
  1814.  
  1815. The 4FILES project is not yet complete.  Future releases will have an
  1816. internal ability to unzip and view archived files, 120-character file
  1817. description ability, a dual-directory workspace for file management, and a
  1818. built-in ability to swap to EMS or XMS memory when calling utilities or
  1819. shelling to DOS.  Your requests for additional features or changes to
  1820. existing ones are very welcome!
  1821.  
  1822.  
  1823. ACKNOWLEDGMENTS:  My deepest thanks to John Fox, Tom Schulte, Mike Bessy,
  1824. Pierre Jelenc, Ward Yelverton, Mack Tanner, Roland Friedrich, Ralf Berg
  1825. and Matt Kahn who have all been of great help to me in various ways in
  1826. refining 4FILES.  Also, special thanks to Matt for making his MAS-BBS
  1827. board available as my home base for tech support, and to Roland for his
  1828. Windows and OS/2 icons.
  1829.  
  1830.  
  1831. ===========================================
  1832. DETAILED INSTRUCTIONS FOR INSTALLING 4FILES
  1833. ===========================================  For simple instructions see
  1834. Quick Start on page 3.  The following assumes you do not have a text editor,
  1835. and it will take but a few  minutes.  "< >" means a keyboard key.
  1836.  
  1837. 1)  The PATH is an internal list of specified drives and subdirectories
  1838. where DOS will look for a program you are trying to execute, if it cannot
  1839. be found on the current drive and directory.  To see if you have a PATH set
  1840. up, type PATH<enter> on the DOS command line.  If the message given is "No
  1841. PATH", go to step 3.  If a list of directories in your PATH is displayed,
  1842. either write down the name of one where you would like to install 4FILES
  1843. and go to step 4, or go to step 3 to add a directory for 4FILES to the
  1844. path.
  1845.  
  1846. 2. Change to your "boot" drive and directory by typing C: (or A: if you
  1847. booted from a floppy) and typing <Enter>.  Then type CD \<Enter> to get to
  1848. the "root" directory.  Type DIR<Enter> and look to see if you have the file
  1849. AUTOEXEC.BAT. If so, go to step 3.
  1850.  
  1851. We will create an AUTOEXEC.BAT file now.  It will be called every time you
  1852. boot your computer, setting your PATH and making a nicer DOS prompt.  Type:
  1853. COPY CON AUTOEXEC.BAT <Enter>.  Then, substituting a drive letter for "d",
  1854. type:  PATH=d:\UTIL<Enter>PROMPT=$P$G<Enter><Ctrl-Z><Enter>.  "UTIL" is a
  1855. suggest directory name for utilities, but any other name may be
  1856. substituted.  Type MD d:\UTIL<Enter> to create the directory if it does
  1857. not exist.  Go to step 4.
  1858.  
  1859. 3.  Add a PATH statement to the end of your existing AUTOEXEC.BAT file by
  1860. typing:
  1861.  
  1862.               COPY AUTOEXEC.BAT + CON AUTOEXEC.BAT<Enter>.
  1863.                    PATH=d:\UTIL<Enter><Ctrl-Z><Enter>
  1864.  
  1865. where "d" is the letter of your boot drive and <Ctrl-Z> is a two key
  1866. combination.  "UTIL" is a suggested directory name for utilities, but any
  1867. other name may be substituted.  Type MD d:\UTIL<Enter> to create the
  1868. directory if it does not exist.
  1869.  
  1870.                                                                          34.
  1871.  
  1872. 4.  4FILES works best if you designate a temporary directory for it to
  1873. use as an out of the way workspace, and some features will not work
  1874. without one.  Type SET<Enter>, and look for a "TEMP=" string on the
  1875. display, and if there is one go to step 5.  Otherwise, type:
  1876.  
  1877.              COPY AUTOEXEC.BAT + CON AUTOEXEC.BAT<Enter>.
  1878.                 SET TEMP=d:\<Enter><Ctrl-Z><Enter>
  1879.  
  1880. This appends the second line to AUTOEXEC.BAT.  Substitute any drive
  1881. letter for "d."  The "\" is required, but you may specify an exisiting
  1882. directory name after it, if desired.  Any drive and directory can be used,
  1883. but a RAM disk is ideal for this purpose.
  1884.  
  1885. 5.  Put the 4FILES disk in drive A:, change to drive A:, and type:
  1886. COPY A:*.* d:\UTIL<Enter> to copy all 4FILES files to the directory.
  1887. (Substitute a different directory for \UTIL as necessary, such as one you
  1888. wrote down in step 1.).  This assumes that you have already unpacked the
  1889. 4FILE???.ZIP file.  If not, and assuming that PKUNZIP is in your path,
  1890. type:   COPY 4FILE???.ZIP d:\UTIL<Enter>
  1891.         PKUNZIP d:\UTIL\4FILE???.ZIP<Enter>
  1892.  
  1893. 6.  4FILES is now installed.  Since 4FILES is in your PATH now, typing 4F
  1894. will start it up no matter what drive or directory you are currently in.
  1895.  
  1896. 7.  Type: CD \, then start 4FILES by typing 4F.  Next hit the <Alt-F10>
  1897. key and "U". The bar will be on the line for the <G+> key (the "grey-plus"
  1898. key).  It is set to 4F-TV.COM (if you don't have an edited 4F.CFG file
  1899. specifying somthing else), a public domain file-viewing program.  We'll add
  1900. a pathspec so 4FILES will find and execute it as fast as possible, without
  1901. having to search your PATH.  Type d:\UTIL\4F-TV.COM, then <ESC> and P.
  1902. A file name extension must be given, otherwise the utility won't be exec-
  1903. uted.  Use an .ALS extension for any DOS or 4DOS internal commands or 4DOS
  1904. aliases.
  1905.  
  1906. Move the bar to the UTIL directory  and then press <G+>.  You are now in
  1907. that directory  (if this fails, try <Scroll-Lock>).  Move down to the
  1908. 4F-READ.ME file and hit <G+> to browse it.  When done, hit <TAB> and
  1909. type (or modify) the file note.  Then hit <G-> to return to the parent
  1910. directory.  Move the bar elsewhere in that list and hit <G*> 3 times.
  1911. You're back to the previous directory.  Quit with <ESC> or <Alt-ESC>.
  1912. More in the manual.  See the Windows section for further Windows setups.
  1913.  
  1914.  
  1915. ===========================================================================
  1916.   AGREEMENT -- USE / REGISTRATION / DISTRIBUTION / & LICENSING OF "4FILES"
  1917. ===========================================================================
  1918.  
  1919.  
  1920. WHAT YOU GET FOR REGISTRATION
  1921. =============================  With registration you receive:  1) The
  1922. latest version of 4FILES and a printed manual;  2) a serial number which
  1923. allows you to brand newer minor releases and the next major version as
  1924. they appear on bulletin boards or at disk vendors <minor versions are
  1925. also optionally available by mail>; 4) a free upgrade to the next major
  1926. version by postal mail or E-mail; and 5) free technical support.
  1927.  
  1928.                                                                         35.
  1929.  
  1930. 4FILES has been a very time consuming project because I have gone to great
  1931. pains both to maximize its convenience and power and to assure protection
  1932. of your data.  Please recognize this effort by registering your copy
  1933. promptly, and by passing 4FILES on to others who might enjoy it.
  1934.  
  1935.  
  1936. AGREEMENT FOR USE AND DISTRIBUTION
  1937. ==================================  4FILES and its documentation are
  1938. copyrighted intellectual property which are distributed as shareware, and
  1939. may be used or distributed only in compliance with the following terms and
  1940. conditions.  4FILES is neither free nor in the public domain.  All rights
  1941. are reserved worldwide by the author.  Any use of 4FILES constitutes your
  1942. agreement to all provisions herein.
  1943.  
  1944.  
  1945. USE & REGISTRATION FOR A SINGLE COMPUTER
  1946. ========================================  Use of 4FILES is free during your
  1947. evaluation period.  This period ends when you begin to use 4FILES for any
  1948. useful work which is not incidental to exploring its capabilities, and may
  1949. not exceed 30-days beyond your acquisition date.  When you use 4FILES for
  1950. the primary purpose of accomplishing useful work (as contrasted to a
  1951. genuine evaluation) you are obligated to do your "share" of the shareware
  1952. arrangement by registering your copy promptly.
  1953.  
  1954.  
  1955. MULTIPLE USE & SITE LICENSING
  1956. =============================  A site license is required if 4FILES can
  1957. potentially be used simultaneously on more than one computer, terminal or
  1958. workstation in a business, institution, organization, government agency,
  1959. home, etc.   To apply for a license, please fill out the registration
  1960. form in 4F_REG.TXT.  A sample site license and rates are contained in the
  1961. file 4F-SITE.TXT
  1962.  
  1963.  
  1964. DISTRIBUTION OF 4FILES
  1965. ======================
  1966. Distribution by any means is encouraged, provided:
  1967.  
  1968. 1) ... that the distribution includes all original files (see Packing
  1969. List, below) in their unaltered forms and with unaltered filenames, and
  1970. does not include the .CFG file.  If the package is incomplete its
  1971. distribution is prohibited; please contact me for a complete package.  A
  1972. BBS may add a tag file listing it as the source, and disk vendors may add
  1973. introductory or installation batch files.
  1974.  
  1975. 2) ... that, unless a higher figure has been approved in writing, the
  1976. distribution fee does not exceed $8 if 4FILES is distributed alone or $12
  1977. (in 1991 dollars) if it is packed on-disk with other programs.  Commercial
  1978. vendors who are not members of ASP must have written permission to
  1979. distribute.  Please inquire as necessary.
  1980.  
  1981. 3) ... that in any vendor catalog or other publication, it is clearly
  1982. stated that this is shareware and that $30 must be paid to Hand-Crafted
  1983. Software if the program is useful, in addition to the distribution fee (if
  1984. any).
  1985.  
  1986.                                                                         36.
  1987.  
  1988. 4) ... that 4FILES may not be included or bundled with other goods or
  1989. services without express written permission of the author.  Inquiries are
  1990. welcome, and a non-shareware version can be produced for such purposes.
  1991.  
  1992.  
  1993. WARRANTY & DISCLAIMER
  1994. =====================  Any use of 4FILES constitutes your agreement that it
  1995. is provided "as-is" with no express or implied warranty (other than free
  1996. technical support), that you assume full responsibility for assuring that
  1997. it performs acceptably on your system, and that in no event shall Larry
  1998. Edwards, Hand-Crafted Software or their successors be held liable for any
  1999. damages arising from use of the program.
  2000.  
  2001.  
  2002. ----------------------------------------------------------------------------
  2003. I hope you think my soft"wares" are terrific; much extra effort has been
  2004. expended toward that end.  Your registration will be (or is) much apprec-
  2005. iated.  Please let me know of any improvements you would like.
  2006. ----------------------------------------------------------------------------
  2007.  
  2008.  
  2009. ============
  2010. PACKING LIST   (All files except 4F.COM, TV.COM & 4F.PIF
  2011. ============    are readable text files.)
  2012.  
  2013.     4F      .COM   4FILES Program file.
  2014.     4F      .DOC   Full documentation.
  2015.     4F      .HLP   HELP text file.
  2016.     4F      .KEY   Alternate HELP text file.
  2017.     4F      .PIF   Setup file for Windows.
  2018.     4F      .VER   Version update details and history.
  2019.     4F-I-OS2.ICO   Icon for use with OS/2.
  2020.     4F-I-WIN.ICO   Icon for use with Windows.
  2021.     4F-KB   .TXT   Keyboard suggestion.
  2022.     4F-NEW  .TXT   Changes in this major upgrade.
  2023.     4F-READ .ME    Introductory information, and a word on compatibility.
  2024.     4F-REG  .TXT   Registration form.
  2025.     4F-SITE .TXT   Sample site license & rates.
  2026.     4F-TV   .COM   Public domain file browser.
  2027.     4F-TV   .DOC   Public domain file browser.
  2028.     4F-VEND .TXT   Info for SYSOPs & disk vendors.
  2029.     FILE_ID .DIZ   Description for BBSs.
  2030.  
  2031. ======================================================================= 37.
  2032.                          4FILES REGISTRATION FORM
  2033.                          ========================
  2034.  
  2035.          Larry T. Edwards // Hand-Crafted Software // (907)-747-8996
  2036.                Box 6001 // Sitka, Ak 99835 USA // (FAX)-747-4801
  2037.  
  2038.  Payment by check or International Postal Money Order to above address
  2039.  preferred.  Credit card payments can be made for $5 extra to:
  2040.  
  2041.     PsL (Program #10574), 800-242-4775, Box 35705 Houston, Tx 77235
  2042.  
  2043.     CompuServe (Program #912), !Go SWREG
  2044.  
  2045.  Your signature here or registration with PsL or CompuServe signifies
  2046.  acceptance of the agreement contained near the end of the documentation.
  2047.  
  2048.  ===== PLEASE PRINT CLEARLY! =====                     4FILES VERSION #____
  2049.  
  2050. Your name: _____________________________________ Position:_________________
  2051.  
  2052. Company: _______________________________________  Phone: (W) ______________
  2053.  
  2054. Street or Box: ___________________________________       (H) ______________
  2055.  
  2056. City/State/Zip: __________________________________  Country: ______________
  2057.  
  2058. I got 4FILES from (name BBS/vendor/etc):________________, ____________ Forum
  2059.  
  2060. E-Mail Addr: CIS ___________. Genie ___________. INTERNET: _________________
  2061.  
  2062. Using 4FILES with:  __ MSDOS  __ DRDOS  __Windows  __OS/2    Version ____
  2063.              with:  __ 4DOS   __ NDOS   __ Neither           Version ____
  2064.  
  2065. Send free major upgrade by __ postal mail, __E-mail ON: __ 5", __ 3" disk.
  2066.  
  2067. $__  Our (my) operation can't possibly use more than one copy of 4FILES
  2068.      simultaneously. $30 ($35 overseas) is enclosed to register one copy.
  2069.      PRICE INCLUDES PRINTED MANUAL and services outlined in "agreement."
  2070.  
  2071. $__  Our (my) operation hereby applies for a site license to install 4FILES
  2072.      for use on up to ___ computers or terminals.  Payment according to the
  2073.      schedule in the file 4F-SITE.TXT is enclosed (call if file is lost).
  2074.  
  2075. $__  Send minor upgrades by postal mail ($4 postage/handling, in advance).
  2076.  
  2077. $__  Send disk(s) of related shareware/public-domain utilities described
  2078.      in manual (3.5" $2.00; 5.25" $4.00; for 4DOS add $2/$4 respectively).
  2079. ====================
  2080. $    TOTAL enclosed.
  2081.  
  2082. Signature: ________________________________________     Date: _____________
  2083.  
  2084. THANK YOU!
  2085. ================================================================
  2086. COMMENTS / PROBLEMS / CHANGES OR ADDITIONS YOU DESIRE IN 4FILES:
  2087. ================================================================
  2088.                (Please comment on the back of this page.)